Seedance 2.5 全能参考 API

01快速开始

异步任务：提交拿 task_id，轮询到 completed 后取成片。

端点别用错。本模型走 POST /v1/videos，不能用 /v1/chat/completions —— 用对话接口调会直接 404，换任何模型名都无解。

Base URL: https://www.salpx.com/v1
鉴权: Authorization: Bearer <SalpX Token>
提交任务: POST /v1/videos
查询状态: GET /v1/videos/{task_id}
代理取片: GET /v1/videos/{task_id}/content
出片耗时: 实测 5 – 7 分钟（4 秒 720p 为 311 – 426 秒）；客户端超时请设 ≥ 600 秒

02模型与价格

模型名	计费	时长	分辨率	价格
`doubao-seedance-2-5-260628`	按秒	4 – 30 秒	720p 固定	¥2.00 / 秒

带参考视频时按 ¥7.00 / 秒计（按输出时长计，不按参考视频时长）。纯文生、图生视频、带参考图或参考音频，均按 ¥2.00 / 秒。

分辨率固定 720p，请求里传其它值无效。

常见规格	费用
4 秒（最短）	¥8.00
10 秒	¥20.00
30 秒（最长）	¥60.00
4 秒 + 30 张参考图 + 30 秒参考音频	¥8.00
4 秒 + 参考视频	¥28.00
10 秒 + 参考视频	¥70.00

03参考素材规则

以下上限全部由真实任务撞出，上游文档只写了个数，没写总时长。

素材	上限	超限时的报错
参考图	最多 30 张	返回 400
参考视频	总时长 ≤ 30.2 秒	`video total duration (seconds) ... must be <= 30.2`
参考音频	总时长 ≤ 30.2 秒	`audio total duration (seconds) ... must be <= 30.2`
单个素材	1.8 – 30.2 秒	`Duration must be between 1.8s and 30.2s`

限制的是总时长，不是个数。想放满 10 个参考视频或 10 段参考音频，每个素材需 ≤ 3 秒；用 4 秒素材放 10 个就是 40 秒，必然超限。实测 10 段 × 3 秒音频（合计 30 秒）可以正常受理。

参考图和参考音频不额外收费。实测 30 张图 + 30 秒音频的任务，与纯文生同价。只有参考视频会推高费用。

04提交任务

4.1 请求格式

文本放顶层 prompt，媒体放 metadata.content，每项带 role：

role	用途
`reference_image`	参考图（主体 / 风格 / 构图）
`reference_video`	参考视频（运镜 / 动作）
`reference_audio`	参考音频（节奏 / 环境声）
`first_frame` / `last_frame`	首帧 / 尾帧，尾帧须与首帧配对；与普通参考互斥

媒体地址可用公网可直接下载的 URL，也可用 data: 开头的 base64 Data URI。

4.2 全能参考（图 + 视频 + 音频）

curl

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "角色跟参考图一致，运镜跟参考视频，节奏贴合参考音频",
    "duration": 4,
    "resolution": "720p",
    "ratio": "16:9",
    "metadata": {
      "content": [
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/char.png"},"role":"reference_image"},
        {"type":"video_url","video_url":{"url":"https://your-cdn.com/motion.mp4"},"role":"reference_video"},
        {"type":"audio_url","audio_url":{"url":"https://your-cdn.com/bgm.mp3"},"role":"reference_audio"}
      ]
    }
  }'

4.3 纯文生视频

curl

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "霓虹都市夜景，镜头缓缓推进，雨后街道倒映灯光",
    "duration": 4,
    "resolution": "720p",
    "ratio": "16:9"
  }'

4.4 视频编辑 / 延长

顶层传 omni_reference_task_type：

取值	说明
`auto`	默认，按提示词自动判断
`reference`	普通参考生成
`edit`	视频编辑，必须带参考视频，用自适应比例
`extend`	视频延长，必须带参考视频

提示词要与任务类型一致：编辑用「修改 / 替换 / 加上 / 去掉」，延长用「延长 / 延续 / 续写」。类型与提示词不符会报错。

05轮询与取片

提交成功返回 task_id，用 GET /v1/videos/{task_id} 轮询，建议间隔 15 秒。状态进入 completed 后从返回体取成片地址；也可用 GET /v1/videos/{task_id}/content 由 SalpX 代理取片。

成片链接有效期 24 小时，过期返回 403。请在有效期内自行转存，不要把链接当长期存储用。

06计费与退款

提交成功即冻结额度，任务失败或超时自动全额退回。

情形	计费公式
文生 / 图生 / 带参考图 / 带参考音频	¥2.00 × 输出秒数
带参考视频	¥7.00 × 输出秒数

失败自动退款。上游失败、超时、或任务进入 failed → 自动退还该次冻结额度，不产生实际扣费。

07错误处理

HTTP	典型信息	处理
404	bad response status code 404	用了 `/v1/chat/completions`，改用 `POST /v1/videos`
400	video / audio total duration ... <= 30.2	参考视频或音频总时长超限，减少数量或改用更短的素材
400	Duration must be between 1.8s and 30.2s	单个素材时长越界
400	参数非法 / 内容风控拦截	检查模型名、时长、分辨率与素材地址
403	token quota is not enough	余额不足以冻结，充值或换令牌
503	No available channel	模型名拼错或令牌分组不对