使用帮助

POST /video/v1/generations 的请求体使用统一结构，不同驱动支持的参数见各驱动页面。

统一请求参数

参数	类型	必需	说明
`model`	`string`	✅	模型名称，如 `doubao-seedance-1-0-pro-250528`、`wan2.1-t2v-turbo`
`prompt`	`string`	✅	文本提示词
`image`	`string` \| `string[]` \| `VideoURL` \| `VideoURL[]`	❌	参考图片；字符串为图片 URL
`video`	`string` \| `string[]` \| `VideoURL` \| `VideoURL[]`	❌	参考视频；Seedance 的 `modality_tokens` 计费会用它判断是否包含输入视频
`audio`	`string` \| `string[]` \| `VideoURL` \| `VideoURL[]`	❌	参考音频
`ratio`	`string`	❌	画幅比例，如 `16:9`、`9:16`、`1:1`
`resolution`	`string`	❌	输出分辨率，如 `480p`、`720p`、`1080p`、`4k`
`upstream_options`	`object`	❌	厂商私有参数，见各驱动页面
`headers`	`object`	❌	自定义请求头

{
  "type": "reference_video",
  "url": "https://example.com/reference.mp4"
}

字段	类型	必需	说明
`type`	`string`	✅	媒体类型或角色。不同驱动对该值的语义略有差异，见各驱动入参映射
`url`	`string`	✅	媒体 URL

{
  "headers": {
    "x-trace-id": "trace-9c1ab",
    "x-user-id": "u_42",
    "x-agent-name": "video-agent"
  }
}

这些字段会记录到任务和用量日志，便于排障与归因。

请求体上限为 50 MB。

image、video、audio 均支持字符串（URL）、对象（VideoURL）或数组。数组会逐项展开；字符串会使用默认 role；对象使用其 type 字段作为 role。

具体映射规则请查看 Seedance 和百炼页面。