Seedance UM 按秒 API

01快速开始

异步任务：提交拿 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/{id}
代理取片: GET /v1/videos/{id}/content
必填参数: model、prompt、duration

02模型与价格

模型名	计费	可选时长	单价	常见规格费用
`seedance-2.0-um`	按秒	5 / 10 / 15 秒	¥0.20 / 秒	5s = ¥1.00 10s = ¥2.00 15s = ¥3.00
`seedance-2.5-um`	按秒	5–15 秒整数，或 30 秒	¥0.25 / 秒	5s = ¥1.25 10s = ¥2.50 15s = ¥3.75 30s = ¥7.50

seedance-2.5-um 的时长支持 5–15 秒的整数，或 30 秒。传其它值会返回 400，报错里会列出可选时长。

档位也可以从 GET /v1/models 的 salpx_metadata.durations 直接读到，无需硬编码。

duration 必须显式传，没有默认值、也不支持自动时长。

seedance-2.5-um 使用限制：支持最多 6 张参考图，不支持参考视频、参考音频和真人生成。模型偶尔可能未正确识别提示词，属于上游模型随机性，当前无法通过接口修复；若成片与提示词不符，请自行重新提交，此类情况不退款。

03提交任务

3.1 文生视频

curl

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-um",
    "prompt": "霓虹都市夜景，镜头缓缓推进，雨后街道倒映灯光",
    "duration": 10
  }'

返回的是 SalpX 自己的任务 ID，后续查询和取片都用它：

200 response

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-um",
  "status": "queued",
  "progress": 0,
  "created_at": 1790160000
}

3.2 请求字段

字段	类型	必填	说明
`model`	string	是	`seedance-2.0-um` 或 `seedance-2.5-um`
`prompt`	string	是	提示词，不可为空白
`duration`	number / string	是	整数秒，只接受第 02 节列出的档位。数字和字符串两种写法都接受
`seconds`	number / string	否	`duration` 的等价别名，二选一即可
`reference_images`	string[]	否	参考图。公网 URL 或 base64 data URI，见 3.3
`ratio`	string	否	画面比例，如 `16:9` / `9:16` / `1:1`
`size`	string	否	分辨率，如 `1280x720`。不是 `resolution`

3.3 参考图

字段 reference_images，字符串数组。公网 URL 与 base64 内联都支持，最多 6 张；不支持参考视频和参考音频。

curl · 文字 + 2 张参考图

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-um",
    "prompt": "参考图中的人物走过雨后霓虹街道，镜头缓慢推进",
    "duration": 10,
    "reference_images": [
      "https://your-cdn.com/ref-1.jpg",
      "https://your-cdn.com/ref-2.jpg"
    ]
  }'

公网 URL 必须免鉴权可访问，带签名的临时地址要确保在出片前不过期。

base64 写法为 "data:image/png;base64,<BASE64>"，jpeg 同理。实测可用，但明显更慢：同样 5 秒的任务，公网 URL 约 3 分钟出片，base64 内联约 26 分钟。批量场景建议用 URL。

3.4 画面比例与分辨率

参数	示例	实测结果
`ratio`	`"9:16"`	出片 720×1280（竖屏）
`size`	`"1280x720"`	出片 1280×720
都不传	—	带参考图时跟随参考图的比例（512×512 方图 → 出片 960×960）

分辨率参数名是 size，不是 resolution —— 传 resolution 会被忽略。

需要固定画幅时请显式传 ratio 或 size，否则有参考图时会跟随参考图。

04轮询与取片

用 GET /v1/videos/{id} 轮询，建议间隔 15 秒。状态流转：queued → processing → completed 或 failed。

curl · 查询状态

curl https://www.salpx.com/v1/videos/task_xxxx \
  -H "Authorization: Bearer $SALPX_KEY"

成片地址在顶层 video_url。取值写法：resp["video_url"]。

本系列没有 metadata.url 字段 —— 那是我们另一条视频线路（LK-seedance-*）的结构，两者不通用，照搬会一直取到空值。

200 response · completed

{
  "id": "task_xxxx",
  "model": "seedance-2.5",
  "prompt": "...",
  "status": "completed",
  "video_url": "http://.../xxxxxxxx.mp4",
  "error": null
}

取片的两种方式

方式	说明
直链下载	`video_url` 是公网绝对地址，直接 GET 即可，不需要鉴权
代理取片	`GET /v1/videos/{id}/content`，需带 `Authorization`，走 SalpX 中转返回同一个文件

成片链接请及时转存。上游返回的是对象存储直链，属于临时地址，不要当长期存储用。

05计费与退款

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

模型	计费公式
`seedance-2.0-um`	¥0.20 × 出片秒数
`seedance-2.5-um`	¥0.25 × 出片秒数

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

06错误处理

HTTP	典型信息	处理
404	bad response status code 404	用了 `/v1/chat/completions`，改用 `POST /v1/videos`
400	duration 超出上限	2.0 最长 15 秒，2.5 最长 30 秒
400	必须传 duration 字段	显式传整数秒，没有默认值
403	token quota is not enough	余额不足以冻结，充值或换令牌
503	No available channel	模型名拼错，或令牌所属分组没有该模型的可用渠道