SalpX · 视频生成接口

Seedance 按次 API（SD-SH · 内测）

Seedance 2.0 / 2.5 共 6 个模型：按次固定价，与时长无关，支持文生视频与图生视频，失败自动退款。

✓ 2026-10-10 内测核对 文生 / 图生视频均已用内部令牌端到端验证；价格取自线上配置

01快速开始

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

内测中。该线路目前仅对已开通的账户分组开放；未开通时提交会返回 503 No available channel，请联系我们开通。价格为内测价，可能调整，以模型广场实时价格为准。

端点别用错。走 POST /v1/videos，不能用 /v1/chat/completions。

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
必填参数
model、prompt
常用选填
seconds（默认 5）、ratio（默认 9:16）、image_url（图生）

02模型与价格

模型名分辨率时长支持画幅参考图价格出片耗时（内测实测）
seedance-2.0-sh720p5 / 10 / 15 秒16:9 / 9:16 / 1:1暂不支持（仅文生视频）¥5.96 / 次内测中，实测耗时待补充
seedance-2.0-903-sh720p5 – 15 秒16:9 / 9:16 / 1:1 / 4:3≤ 9 张¥8.03 / 次内测中，实测耗时待补充
seedance-2.0-7ref-720p-sh720p4 – 12 秒21:9 / 16:9 / 4:3 / 1:1 / 9:16≤ 7 张¥4.13 / 次约 20 分钟（实测 20.6 分钟）
seedance-2.0-7ref-1080p-sh1080p4 – 12 秒21:9 / 16:9 / 4:3 / 1:1 / 9:16≤ 7 张¥5.05 / 次约 20 分钟或更久（同系列 720p 实测 20.6 分钟）
seedance-2.0-7ref-2k-sh2K4 – 12 秒21:9 / 16:9 / 4:3 / 1:1 / 9:16≤ 7 张¥5.96 / 次约 20 分钟或更久（同系列 720p 实测 20.6 分钟）
seedance-2.5-sh720p4 – 30 秒1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 21:9≤ 10 张¥4.82 / 次约 30 分钟（实测 31.9 分钟）

分辨率由模型名决定，同一模型不能切换分辨率；想要不同分辨率请换模型名。

按次计费，与时长无关。同一个模型 4 秒和 15 秒收费相同；请在表内的时长范围内选择。

03提交任务

3.1 请求字段

字段说明
model必填，见上表模型名。
prompt必填，≤ 20000 字符。
seconds整数秒（也可用 duration）。必须在该模型的时长范围内（seedance-2.0-sh 只有 5 / 10 / 15 三档），超出直接 400，不会自动改成相近值；不传默认 5。
ratio / aspect_ratio画幅，如 9:16。必须是该模型支持的比例，否则 400；不传默认 9:16。
size可选，如 720x1280，仅用于推断画幅（按宽高比匹配，不能匹配到该模型支持的比例则 400）；不决定分辨率。
image_url图生视频的参考图（seedance-2.0-sh 暂不支持参考图，仅文生视频），公网 https 直链；多张用 | 分隔，数量不超过上表上限。暂不支持上传本地文件，也不支持 http://、内网地址与 IP 地址。

3.2 文生视频

curl · 文生视频
curl https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0-7ref-720p-sh","prompt":"清晨湖面薄雾，镜头缓慢推进","seconds":5,"ratio":"9:16"}'

3.3 图生视频（参考图直链）

curl · 图生视频
curl https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0-7ref-720p-sh","prompt":"画面中的人物转身微笑","seconds":5,"image_url":"https://cdn.example.com/a.jpg|https://cdn.example.com/b.jpg"}'

3.4 提交成功的响应

JSON
{"id":"task_xxxx","object":"video","status":"queued"}

拿 id 去轮询。

04轮询与取片

用 GET /v1/videos/{id} 轮询，建议间隔 10 秒。状态流转：queued → in_progress → completed 或 failed。以 status 判断是否结束。

curl · 查询状态
curl https://www.salpx.com/v1/videos/task_xxxx \
  -H "Authorization: Bearer $SALPX_KEY"

耗时差异很大，请按模型预期。实测：7 图系列约 20 分钟；2.5 约 30 分钟；seedance-2.0-sh 与 seedance-2.0-903-sh 为新接入，内测中，耗时可能较长。请把客户端 / 任务超时设为 ≥ 45 分钟，用轮询而不是长连接等待。断开连接不会取消任务，用 id 随时可接着查。

失败会自动全额退款。上游生成失败或超时，任务状态转为 failed，已冻结的额度自动退回，不需要你操作。

取片：统一用代理取片

status 为 completed 后，用下面的接口下载成片（带同一个 Token），返回 mp4 字节流：

curl · 代理取片
curl -L https://www.salpx.com/v1/videos/task_xxxx/content \
  -H "Authorization: Bearer $SALPX_KEY" \
  -o output.mp4

不要依赖查询结果里的视频地址字段。完成时不返回直链，请统一用 /v1/videos/{id}/content 取片。成片请及时转存，不要当长期存储用；未完成时调用取片接口会返回错误而不是视频。

提交后不支持撤销。

05计费与退款

情形费用
成功出片按模型固定价 / 次
参数不合法被拒（时长、画幅、参考图数量与格式等）不扣费
生成失败 / 超时自动全额退款

按次计费，与时长、参考图数量无关。提交时冻结该模型的单价，任务失败自动退回。

06错误处理

HTTP典型信息处理
400时长 / 画幅不在该模型范围；参考图过多、不是 https 直链或格式不对；prompt 为空或过长按提示修正后重新提交，不扣费
403token quota is not enough余额不足以冻结单价，充值或换令牌
429该线路今日额度用完 / 上游限流稍后重试，不扣费
503No available channel / 线路暂不可用模型名拼错或账户分组未开通；或线路临时故障，稍后重试，不扣费
504提交结果未知（可能已被上游受理）请勿重复提交，联系客服核对；确认未生成会退款

以上 400 类错误都在提交时当场返回，不会冻结或扣除额度。

内容审核：上游可能对提示词与参考图做内容审核，命中时任务会失败并自动退款。建议只描述画面与风格，避免直接点名受版权保护的作品 / 角色 / 品牌。