流程
视频生成是异步任务,分三步:POST /v1/videos提交任务,拿到任务id。GET /v1/videos/{id}轮询进度,直到status为completed或failed。GET /v1/videos/{id}/content下载 MP4。
Authorization: Bearer YOUR_API_KEY 认证。
提交任务
model、prompt、seconds,其余参数按火山方舟官方格式写在 metadata 里,见 Seedance 2.5、2.5 Flash、Seedance 2.0、2.0 Fast、2.0 Mini。MiniMax 的分辨率、比例和参考素材也写在 metadata 里,见 MiniMax-H3、MiniMax-H3 量化版 和 MiniMax-H3-Max。万相用外层 resolution、ratio,首尾帧放在 images 里,见 万相 3.0、万相 2.7。
各型号参数
除
wan2.7-t2v(只做文生视频)和 wan2.7-i2v(只做图生视频)外,所有型号都支持文生视频,以及首帧 / 首尾帧图生视频。Seedance、MiniMax-H3(含量化版)和万相 3.0 还支持用图片、视频、音频做多模态参考。
需要反复使用的参考图、视频、音频可以先上传到 素材库,再用 asset:// 引用,不用自己托管文件。带真人人脸的照片要作为人像素材上传,才能用于 Seedance。
示例:文生视频
示例:首尾帧图生视频
查询进度
失败时的响应示例:
error.code 为 content_policy_violation 表示内容审核拒绝,error.message 给出处理建议。Seedance 参考图被识别为真人时,请在确认有权使用该照片后,把它作为人像素材上传,等待审核通过,再用返回的 asset:// 引用生成。
下载视频
metadata.output_format 选择 MP4 或 MOV。
计费
- 可灵:按秒计费,按分辨率和是否有声分档,费用为「单价 × 时长」。
- Seedance:按任务实际使用的视频 token 计费,按分辨率和是否带参考视频分档,完成后按实际用量多退少补。
- Seedance 2.5 Flash:两档分辨率使用相同的 token 单价,按有无参考视频分档。
- 提交任务时按请求的时长、分辨率预扣费用;任务失败后自动全额退回。
- 各型号的实时单价见 模型广场,更多说明见 价格说明。
常见错误
Seedance 的常见错误见 Seedance 2.5、2.5 Flash、Seedance 2.0。其他错误见 排错指南。