MAPI
Videos

Create Video Generation Task

Submit a video generation task, supporting text-to-video and image-to-video.

Returns the task ID. The task status can be queried via the GET API.

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不传 Duration / Resolution / AspectRatio
Mingmou 1.0不传 Duration / Resolution / AspectRatio

Sora 见「Sora 系列」文档,Veo 见「Veo 系列」文档,HappyHorse 见「HappyHorse 系列」文档,PixVerse 见「PixVerse 系列」文档,Hailuo 见「Hailuo 系列」文档,Vidu 见「Vidu 系列」文档,可灵见「可灵系列」文档,豆包 Seedance 见「豆包系列」文档。请求体中的 model 取值见各系列文档。

prompt?string

文本描述提示词。t2v 模式必填;i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长(秒)。各模型对时长的支持方式不同:

模型合法值默认值实现行为
Hunyuan不支持—忽略此字段
Mingmou不支持—忽略此字段

Sora 时长见「Sora 系列」文档,Veo 时长见「Veo 系列」文档,HappyHorse 时长见「HappyHorse 系列」文档,PixVerse 时长见「PixVerse 系列」文档,Hailuo 时长见「Hailuo 系列」文档,Vidu 时长见「Vidu 系列」文档,可灵时长见「可灵系列」文档,豆包 Seedance 时长见「豆包系列」文档。

resolution?string

分辨率。Hunyuan、Mingmou 不支持,传入后忽略。

Sora 的分辨率见「Sora 系列」文档,Veo 见「Veo 系列」文档,HappyHorse 见「HappyHorse 系列」文档,PixVerse 见「PixVerse 系列」文档,Hailuo 见「Hailuo 系列」文档,Vidu 见「Vidu 系列」文档,可灵见「可灵系列」文档,豆包 Seedance 见「豆包系列」文档。

ratio?string

宽高比。Hunyuan、Mingmou 不支持,传入后忽略。

Sora 的宽高比见「Sora 系列」文档,Veo 见「Veo 系列」文档,HappyHorse 见「HappyHorse 系列」文档,PixVerse 见「PixVerse 系列」文档,Hailuo 见「Hailuo 系列」文档,Vidu 见「Vidu 系列」文档,可灵见「可灵系列」文档,豆包 Seedance 见「豆包系列」文档。

seed?integer

随机种子,控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。可灵、Vidu、Hailuo、PixVerse、HappyHorse、Veo、Sora、豆包见各自系列文档。

字段类型说明
contentarray素材列表。见下方元素字段
negative_promptstring反向提示词。Hunyuan / Mingmou
enhance_promptstring自动优化提示词,Enabled / Disabled。Hunyuan / Mingmou
audio_generationstring是否生成 AI 音频,Enabled / Disabled。有值即转发
enhance_switchstring视频超分增强,Enabled / Disabled。Hunyuan / Mingmou

content 元素结构

字段类型说明
typestringimage_url / video_url / audio_url
rolestring见下表。各系列可用取值不同
image_url.urlstring图片地址
video_url.urlstring视频地址
audio_url.urlstring音频地址
reference_typestring写在对应那一项上。细节见各系列文档
namestringPixVerse 在提示词里用 @名字 引用,见「PixVerse 系列」

role 取值:

role适用 type说明
first_frameimage_url首帧。必须显式填写,省略时按参考图提交
last_frameimage_url尾帧
reference_imageimage_url参考图
reference_videovideo_url参考视频
reference_audioaudio_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"  }'
{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}
{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Last updated on