这一项共 7 个参数，其中必填的是 prompt。参数名、取值范围与默认值以本页下方的目录为准：接口按这份契约严格校验，未知参数直接报错，不会静默丢弃。
调用方式是「提交即返回任务号、再轮询取结果」：文本与图片类通常十几秒到一分钟，视频类一条按分钟计。排队中的任务会给出队列位置，那不代表失败。
这一项可以指定 model：不传就走默认档。可选档位：
turbo4（默认）turbo
参数契约
| 参数 | 必填 | 说明 | 取值与边界 |
|---|---|---|---|
prompt | 必填 | 画面/剧情提示词 | string |
first_frame | 可选 | 首帧图片 | material；kind=image |
last_frame | 可选 | 尾帧图片 | material；kind=image |
duration | 可选 | 成片时长（秒），2–15 | number；≤15；≥2；默认 5 |
aspect_ratio | 可选 | 画幅比：16:9=16:9 横屏 / 9:16=9:16 竖屏 / 1:1=1:1 方形 / 4:3=4:3 标准 / 3:4=3:4 竖屏；缺省继承部署默认 | string；或：16:9/9:16/1:1/4:3/3:4 |
quality | 可选 | 清晰度：480p=480p 标清 / 768p=768p 高清 / 1080p=1080p 超清 / 2k=2K 超清；缺省继承部署默认 | string；或：480p/768p/1080p/2k |
seed | 可选 | 随机种子 | integer；≤4294967295；≥0 |
调用示例
{
"task_type": "video_first_last",
"params": {
"prompt": "镜头从首帧平滑过渡到尾帧",
"first_frame": {
"url": "https://example.com/a.png"
},
"last_frame": {
"url": "https://example.com/b.png"
}
}
}常见问题
- 首尾帧生视频怎么计费？
- 按「video_gen」这一计费项从账户余额扣除。提交时按最低档预扣，跑完按实际用量结算；任务失败不计费，预扣部分解冻回余额。
- 生成的文件在哪里？
- 任务完成时在结果里给出签名直链，图片、视频、音频都是这个形式。直链 24 小时过期，需要长期留存请自行转存。
- 可以直接在网页上用吗？
- 可以。自由工作台与短剧流水线里都有这一项的界面入口，接口与 MCP 是给系统和智能体调用的同一能力。