Seedance 2.5 满血版 视频 API

模型与参数

每次输出一个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

参考视频与音频

referenceVideoUrls、referenceAudioUrls 为公开 HTTP(S) URL 数组，videoInputMode 使用 keyframes；提供媒体时可省略输入模式。参考视频最多 10 段，每段不超过 30 秒，合计不超过 30 秒，每段不超过 200MB；参考音频最多 10 段，每段不超过 30 秒，合计不超过 30 秒，每段不超过 15MB。素材组合由模型能力校验。时长由服务端检测，不接受客户端上报；首次报价导入并检测素材，后续请求复用已检测素材。

{
  "modelId": "seedance-2-5-full",
  "prompt": "参考视频中的镜头运动，使用音频中的声音方向",
  "imageSize": "480p",
  "duration": 5,
  "videoInputMode": "keyframes",
  "referenceVideoUrls": [
    "https://example.com/reference.mp4"
  ],
  "referenceAudioUrls": [
    "https://example.com/reference.mp3"
  ]
}

报价与 API 积分

默认配置：每次 0.7438 API 积分（5 秒）。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。分辨率、时长、声音与快速模式可能影响价格。

1 美元 = 1 API 积分，支持小数。API 钱包和价格独立，不享受网站会员折扣。提交时冻结 API 积分，任务结束后按模型规则结算。充值 API 积分

查询与下载视频

成功提交返回 HTTP 202 和 taskId。每 3–5 秒请求 GET /api/v1/tasks/{taskId}，queued 和 processing 状态继续等待；succeeded、partial、failed 状态停止轮询。settled 为 true 时，chargedPoints 是最终扣费。

task.videos[].url 是本站视频下载路径，下载也必须携带 API Key。视频遵循本站保留期限，过期返回 410，请及时下载保存。只能访问本人 API 任务。

幂等重试

每个新任务设置不同的 Idempotency-Key，8–128 位字母、数字或 ._:-。超时重试保持相同键和参数，避免重复冻结；改变参数返回 409。有效密钥不设请求频率和网页会员并发上限。

错误处理

400 参数或报价组合无效；401 密钥无效；402 API 积分不足；404 任务不存在或无权访问；409 幂等冲突；410 视频已过期；5xx 服务暂不可用。错误包含 error 和 code，不返回内部调用信息。