SalpX · 视频生成接口

全能视频 2.5 按次 API

模型 seedance-2.5-bk：720p，15 – 30 秒任选，最多 30 张参考图 + 10 段参考视频 + 10 段参考音频。按次计费 ¥20 / 次，与时长无关，失败自动退款。

✓ 2026-10-20 线上核对 价格、时长档位、端点均取自线上配置

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
必填参数
model、prompt、seconds（15 – 30 的整数）

时长字段是 seconds，不是 duration。本模型只认 seconds；传 duration 不生效，会按默认 30 秒出片，且照样按 ¥20 / 次计费。

02模型与价格

模型名分辨率时长参考图参考音频参考视频价格
seedance-2.5-bk720p15 – 30 秒≤ 30 张≤ 10 段≤ 10 段¥20 / 次

时长为 15 – 30 秒的整数，默认 30 秒。传其它值（如 5、10、31）会直接返回 400，不扣费。所有时长同价。

是否可用取决于账户分组。未开通时提交会返回 503 No available channel，请联系我们开通。

03提交任务

3.1 请求字段

字段类型必填说明
modelstring是固定 seedance-2.5-bk
promptstring是提示词，不能为空
secondsinteger是15 – 30 的整数，默认 30
sizestring否1280x720（横屏）或 720x1280（竖屏）
imagesstring[]否JSON 请求：参考图公网地址数组，最多 30 张。也兼容 image_url（单个）/ image_urls（数组），三者合并计数
image_urlsstring否multipart 请求：参考图公网地址，可重复提交；也可直接上传 images 文件
audio_urlsstring否multipart 请求：参考音频公网地址，可重复提交，最多 10 段；也可直接上传 audios 文件（mp3 / m4a / wav / aac / flac / ogg）
video_urlsstring否multipart 请求：参考视频公网地址，可重复提交，最多 10 段；也可直接上传 videos 文件（mp4 / mov / webm / m4v）

参考视频、参考音频请用 multipart/form-data 提交（同名字段可重复）。带参考视频同样按次计费，不另收费。素材地址必须是公网可直接下载的 HTTP / HTTPS 地址，内网地址、需要登录或带防盗链的地址会失败。

3.2 纯文生视频

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-bk",
    "prompt": "夜晚的城市街道，霓虹灯倒映在雨后的路面，镜头缓缓推进",
    "seconds": 15,
    "size": "1280x720"
  }'

3.3 参考图（JSON）

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-bk",
    "prompt": "角色与参考图一致，在海边奔跑，电影感镜头",
    "seconds": 30,
    "size": "720x1280",
    "images": [
      "https://your-cdn.com/char-1.png",
      "https://your-cdn.com/char-2.png"
    ]
  }'

3.4 参考图 + 参考音频（multipart）

带参考音频请用 multipart/form-data，同名字段可重复提交。

curl
curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -F "model=seedance-2.5-bk" \
  -F "prompt=人物动作跟随参考音频的节奏" \
  -F "seconds=15" \
  -F "image_urls=https://your-cdn.com/char-1.png" \
  -F "image_urls=https://your-cdn.com/char-2.png" \
  -F "audio_urls=https://your-cdn.com/bgm.mp3"

3.5 提交成功的响应

返回的是 SalpX 自己的任务 ID（task_ 开头），后续查询和取片都用它。

200 response
{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.5-bk",
  "status": "queued",
  "progress": 0
}

04轮询与取片

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

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

取片：统一用代理取片

status 为 completed 后，用下面的接口下载成片（带同一个 Token）：

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计费与退款

情形费用
成功出片（15 – 30 秒任意时长）¥20 / 次
参数不合法被拒（时长、参考视频、素材数量等）不扣费
生成失败 / 超时自动全额退款

按次计费，与时长、参考素材数量无关。提交时冻结 ¥20，任务失败自动退回。

06错误处理

HTTP典型信息处理
404bad response status code 404用了 /v1/chat/completions，改用 POST /v1/videos
400您选用的时长不可用seconds 须为 15 – 30 的整数
400参考视频数量超限或格式不支持参考视频 ≤ 10 段，格式 mp4 / mov / webm / m4v
400参考图 / 参考音频数量超限、格式错误参考图 ≤ 30 张，参考音频 ≤ 10 段，地址需公网可直接下载
403token quota is not enough余额不足以冻结 ¥20，充值或换令牌
429请求过于频繁退避后重试
503No available channel模型名拼错，或账户分组未开通该模型

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