Create Video Generation Task

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

In: header

模型 ID。

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

图片 / 视频 URL 数组，用于图生视频和多素材输入场景。

Kling / Vidu / Hailuo / Google Veo / Sora / PixVerse / Hunyuan / Mingmou 输入模式由数组长度和 metadata 中的控制字段共同决定：

per-model 支持情况：

Kling i2v 注意：使用首帧图片生成时，视频宽高比由首帧图片自动决定，AspectRatio 无效（传了也会被忽略）。

HappyHorse 系列：

• happyhorse-1.0-i2v：images[0] 为首帧图片
• happyhorse-1.0-r2v：传 1 个或多个参考图片 URL
• happyhorse-1.0-video-edit：images[0] 为待编辑视频 URL，images[1:] 为参考图（可选）

豆包 Seedance 系列：图片 / 视频通过 metadata.content 多模态数组传入，不使用 images 字段。

视频时长（秒）。各模型对时长的支持方式不同：

输出分辨率 / 宽高比。优先级高于 metadata.resolution。

支持两种格式：

• 宽x高（如 "1920x1080"）：按短边自动归档到最近分辨率档位
• 分辨率档位（如 "720P"、"720p"、"1080P"）：直接匹配模型合法值

分辨率档位 per-model 对照表：

宽高比 per-model 对照表：

宽高比通过 size 字段同时传入（如 "16:9"），也可传 宽x高 由系统自动推导。

不支持的宽高比会自动取最近邻值。传入 "WxH" 格式时同时推导宽高比和分辨率档位。

Seedance 系列 支持通过外层 size 字段传入：传入 宽x高 格式（如 "1920x1080"）时自动推导分辨率档位和宽高比；传入分辨率档位格式（如 "720p"）时仅推导分辨率，宽高比保持 metadata.ratio 设置（未设置则自适应）。分辨率全小写，支持档位因模型而异，详见 metadata.resolution 说明。

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

生成视频数量。固定为 1，全部模型均不支持批量生成（视频生成为异步任务，每次提交产生一个任务）。

响应格式，默认 url。

用户标识，用于日志追踪。

扩展参数，按需传入。不同渠道 / 模型支持的字段不同，不支持的字段将被忽略。

Kling / Vidu / Hailuo / Google Veo / Sora / PixVerse / Hunyuan / Mingmou 系列字段

pixverse_subjects 格式示例：

[
  {"url": "https://example.com/cat.jpg", "type": "subject", "name": "小猫"},
  {"url": "https://example.com/bg.jpg", "type": "background", "name": "背景"}
]

在 Prompt 中用 @名字 引用对应主体（如 "让 @小猫 奔跑"）。

Seedance 系列专用字段

content 格式说明：

每个元素为一个对象，字段如下：

示例（图片参考）：

[
  {
    "type": "image_url",
    "role": "reference_image",
    "image_url": {"url": "https://example.com/portrait.jpg"}
  }
]

HappyHorse 专用字段