MAPI
视频(Videos)混元系列

混元视频生成

提交混元视频生成任务。

请求地址仍为 POST /v1/video/generations,完成后用 GET /v1/video/generations/{task_id} 查询。

支持文生、首帧和参考图。首帧写 metadata.content,role=first_frame。不写 role 时按参考图处理。不支持尾帧和参考视频。

不传时长、分辨率、宽高比。上游没有这三项。

各字段说明见下方接口文档。

POST
/v1/video/generations

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

模型说明
Hunyuan 1.5文生、首帧、参考图。不传时长、分辨率、宽高比
prompt?string

文本描述提示词。文生必填;首帧和参考图建议填写。

seed?integer

随机种子,控制生成结果可复现性。

metadata?

扩展参数。不支持尾帧和参考视频。

字段类型说明
contentarray素材列表。见下方元素字段
negative_promptstring反向提示词
enhance_promptstring自动优化提示词,Enabled / Disabled
enhance_switchstring视频超分增强,Enabled / Disabled

content 元素结构

字段类型说明
typestringimage_url
rolestring见下表
image_url.urlstring图片地址

role 取值:

role适用 type说明
first_frameimage_url首帧。必须显式填写,省略时按参考图提交
reference_imageimage_url参考图

Response Body

application/json

application/json

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "hunyuan-video-1.5",    "prompt": "宇航员站起身走了",    "seed": 20231234  }'
{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

最后更新于