这一项共 3 个参数，其中必填的是 sources。参数名、取值范围与默认值以本页下方的目录为准：接口按这份契约严格校验，未知参数直接报错，不会静默丢弃。
调用方式是「提交即返回任务号、再轮询取结果」：文本与图片类通常十几秒到一分钟，视频类一条按分钟计。排队中的任务会给出队列位置，那不代表失败。
参数契约
| 参数 | 必填 | 说明 | 取值与边界 |
|---|---|---|---|
sources | 必填 | 按顺序合成的视频素材列表（公网 url / base64，最多 30 条） | material_list；kind=video；数量≤30 |
resolution | 可选 | 合成母版目标短边：480/720/1080=原生档，1440=2K，2160=4K；缺省 1080 | integer；或：480/720/1080/1440/2160；默认 1080 |
audio | 可选 | 是否混入音频（对白/旁白/BGM + 响度对齐）；false 只出画面、保留源音频 | boolean；默认 true |
调用示例
{
"task_type": "video_compose",
"params": {
"sources": [
{
"url": "https://example.com/a.mp4"
}
],
"resolution": 1080,
"audio": true
}
}常见问题
- 视频合成怎么计费？
- 按「video_compose」这一计费项从账户余额扣除。提交时按最低档预扣，跑完按实际用量结算；任务失败不计费，预扣部分解冻回余额。
- 生成的文件在哪里？
- 任务完成时在结果里给出签名直链，图片、视频、音频都是这个形式。直链 24 小时过期，需要长期留存请自行转存。
- 可以直接在网页上用吗？
- 可以。自由工作台与短剧流水线里都有这一项的界面入口，接口与 MCP 是给系统和智能体调用的同一能力。