Video Generations 视频生成

视频生成接口统一支持 文生视频、图生视频、参考生视频、视频编辑 等能力，采用异步任务模式。 阿里（通义万相 / HappyHorse）模型按 秒 计费，火山（豆包 Seedance）模型按 Token 计费。 多参考能力的模型（首帧 / 尾帧 / 多参考图 / 多参考视频 / 参考音频）在左侧『模型文档』中单独说明。

请求头 Headers

通用请求参数

参考输入参数（多参考）

支持参考输入的模型可使用以下参数。所有 URL 均为网络可访问地址（无需先上传到本平台），支持单值与复数数组（如 image_url 与 image_urls）。

各模型对上述参数的支持、数量上限、必填关系不同，务必参考对应的模型文档： wan3.0 ｜ wan2.7-i2v ｜ wan2.7-videoedit ｜ happyhorse-i2v ｜ happyhorse-r2v ｜ doubao-seedance。

文生视频示例

POST /api/openai/videosGenerations
Authorization: Bearer sk-xxxxxxxx
Content-Type: application/json

{
  "model": "wan2.7-t2v",
  "prompt": "未来城市，机器人行走，电影级画面",
  "duration": 5,
  "size": "1280*720"
}

图生视频示例（首帧参考）

{
  "model": "wan2.7-i2v",
  "prompt": "让画面中的河流流动起来",
  "first_frame_url": "https://example.com/first.jpg",
  "last_frame_url": "https://example.com/last.jpg",
  "duration": 5,
  "size": "1280*720"
}

成功返回

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": 76,
    "provider_task_id": "c0f4277d-...",
    "status": "pending"
  }
}

任务创建成功后，请调用 Video Task 视频任务查询 接口轮询生成结果，成功后返回 video_url，任务失败不扣费。

友好容错提示

平台在调用上游前会做输入校验，缺参或参数不支持时返回友好 400 提示（不会触发 5xx 崩溃）：

// 必填参考图缺失
{ "code": 400, "msg": "该模型必须提供 首帧图(参数 first_frame_url)" }
{ "code": 400, "msg": "该模型必须提供 参考图(参数 image_url)" }
{ "code": 400, "msg": "该模型必须提供 待编辑视频(参数 video_url)" }

// 分辨率不支持
{ "code": 400, "msg": "该模型不支持 2160P 分辨率，支持档位：480P/720P/1080P" }

支持的模型

文生视频（统一标准）模型如下；多参考模型见下方及左侧『模型文档』。

计费说明

错误码