跳转到主要内容

流程

视频生成是异步任务,分三步:
  1. POST /v1/videos 提交任务,拿到任务 id。
  2. GET /v1/videos/{id} 轮询进度,直到 status 为 completed 或 failed。
  3. GET /v1/videos/{id}/content 下载 MP4。
一条视频通常需要 1–5 分钟。建议每 10–15 秒查询一次,不要高频轮询。 所有请求都使用 Authorization: Bearer YOUR_API_KEY 认证。

提交任务

下表是可灵的字段。Seedance 外层只有 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。
首帧、尾帧只接受公网可访问的 http(s) 图片 URL,不支持上传文件或 Base64。图生视频的画面比例跟随首帧图片,此时 aspect_ratio 不生效。

各型号参数

除 wan2.7-t2v(只做文生视频)和 wan2.7-i2v(只做图生视频)外,所有型号都支持文生视频,以及首帧 / 首尾帧图生视频。Seedance、MiniMax-H3(含量化版)和万相 3.0 还支持用图片、视频、音频做多模态参考。 需要反复使用的参考图、视频、音频可以先上传到 素材库,再用 asset:// 引用,不用自己托管文件。带真人人脸的照片要作为人像素材上传,才能用于 Seedance。

示例:文生视频

示例:首尾帧图生视频

提交成功后返回任务对象(示例结构):

查询进度

失败时的响应示例:
error.code 为 content_policy_violation 表示内容审核拒绝,error.message 给出处理建议。Seedance 参考图被识别为真人时,请在确认有权使用该照片后,把它作为人像素材上传,等待审核通过,再用返回的 asset:// 引用生成。
查询任务返回 HTTP 200 只表示查询成功。客户端必须检查 status:遇到 failed 就停止轮询并展示 error.message,不要统一提示“模型、尺寸或时长错误”,也不要自动重发生成请求。失败任务的预扣费用自动退回,实际退费记录可在控制台用量日志中核对。

下载视频

返回视频文件内容。Seedance 2.5 Flash 可通过 metadata.output_format 选择 MP4 或 MOV。
任务成功后,平台会自动保存一份视频,约 30 天内都可以通过这个接口下载,支持 Range 断点续传和拖动播放。保存还没完成或保存失败时,接口改为转发源文件链接,这时可灵视频约 7 天、Seedance 视频约 24 小时后无法下载。过期后接口返回错误(通常是 410,错误码 artifact_gone),无法再取回,请在任务完成后及时下载,转存到自己的存储。

计费

  • 可灵:按秒计费,按分辨率和是否有声分档,费用为「单价 × 时长」。
  • Seedance:按任务实际使用的视频 token 计费,按分辨率和是否带参考视频分档,完成后按实际用量多退少补。
  • Seedance 2.5 Flash:两档分辨率使用相同的 token 单价,按有无参考视频分档。
  • 提交任务时按请求的时长、分辨率预扣费用;任务失败后自动全额退回。
  • 各型号的实时单价见 模型广场,更多说明见 价格说明。

常见错误

Seedance 的常见错误见 Seedance 2.5、2.5 Flash、Seedance 2.0。其他错误见 排错指南。