Seedance 2.5 YY

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
模型名: 480p seedance-2.5-480p-yy；720p seedance-2.5-720p-yy
必填参数: model、prompt、duration（15 – 30 整数秒）、ratio（16:9 或 9:16）
客户端超时: 建议轮询总超时 ≥ 900 秒

分辨率由模型名决定，不用传。请求体里的 resolution 会被改成模型名对应的分辨率。

02模型与价格

按出片秒数计费：单价 × duration = 总价。价格单位为人民币元 / 秒。

模型名	分辨率	单价	15 秒	20 秒	30 秒
`seedance-2.5-480p-yy`	480p	¥0.45 / 秒	¥6.75	¥9.00	¥13.50
`seedance-2.5-720p-yy`	720p	¥0.63 / 秒	¥9.45	¥12.60	¥18.90

参考图、参考音频不加价，只按出片秒数计。提交成功即扣费；任务失败或被拒自动全额退回。

03参数与素材规则

项目	规则
出片时长 `duration`	15 – 30 秒整数
画幅 `ratio`	`16:9` 或 `9:16`，必须显式传
参考图	最多 30 张
参考音频	最多 10 段，总长 ≤ 30 秒；请搭配至少一张参考图
参考视频	不支持（传了直接返回 400，不扣费）

媒体地址必须是公网可直接下载的 URL（上游服务器要能取到文件）。私有云链接、需要登录或带防盗链的地址会取片失败。audio_url 必须是真音频文件（wav / mp3 等）。

提示词和素材会经过内容审核，涉及暴力、惊吓、色情、政治等内容会被拒绝（任务 failed，自动退款）。

04提交任务

4.1 请求格式

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

role	用途
`reference_image`	参考图（主体 / 风格 / 构图）
`reference_audio`	参考音频（配乐 / 节奏 / 环境声）

4.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-480p-yy",
    "prompt": "一朵花在微风中轻轻摇曳，柔和自然光，特写镜头",
    "duration": 15,
    "ratio": "16:9"
  }'

4.3 参考图 + 参考音频

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-720p-yy",
    "prompt": "画面主体与图片1一致，镜头缓慢推进，配上音频1的背景音乐",
    "duration": 15,
    "ratio": "9:16",
    "metadata": {
      "content": [
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/product.png"},"role":"reference_image"},
        {"type":"audio_url","audio_url":{"url":"https://your-cdn.com/bgm.mp3"},"role":"reference_audio"}
      ]
    }
  }'

4.4 提交成功的响应

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

200 response

{
  "id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "task_id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "object": "video",
  "model": "seedance-2.5-480p-yy",
  "status": "queued",
  "progress": 0,
  "created_at": 1793700000
}

id 和 task_id 恒为同一个值，新接入用 id 即可。

05轮询与取片

用 GET /v1/videos/{id} 轮询，建议间隔 15 秒。

curl · 查询状态

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

`status`	含义
`queued`	排队中
`in_progress`	生成中
`completed`	已完成，成片地址在 `metadata.url`
`failed`	失败，原因在顶层 `error`；已自动退款

成片地址在 metadata.url，不在顶层。取值写法：resp["metadata"]["url"]。任务未完成时为空字符串。progress 只是状态的粗略映射，请以 status 判断是否结束。

200 response · completed

{
  "id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "task_id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "object": "video",
  "model": "seedance-2.5-480p-yy",
  "status": "completed",
  "progress": 100,
  "created_at": 1793700000,
  "completed_at": 1793700400,
  "metadata": {
    "url": "https://video.example.com/xxxx.mp4"
  }
}

取片方式	说明
直链下载	`metadata.url` 是公网地址，直接 GET 即可
代理取片	`GET /v1/videos/{id}/content`，需带 `Authorization`，由 SalpX 中转返回同一个文件

成片链接请及时转存。直链是临时地址，会过期，不要当长期存储用。

06错误处理

HTTP	典型信息	处理
404	bad response status code 404	用了 `/v1/chat/completions`，改用 `POST /v1/videos`
400	`duration_out_of_range`	15 – 30 秒，整数
400	`reference_video_not_allowed`	本系列不支持参考视频，去掉 `video_url`
400	请指定明确 ratio，例如 16:9	`ratio` 传 `16:9` 或 `9:16`，不要传 `adaptive`
400	`too_many_reference_images` / `audios`	减少素材数量，上限见第 03 节
—	任务 `failed`：内容未通过平台审核	调整提示词或更换素材后重试
—	任务 `failed`：素材下载失败	媒体 URL 需公网可直接下载
403	token quota is not enough	余额不足，充值或换令牌
503	No available channel / model_not_found	模型名拼错（只有 480p、720p 两档）或令牌分组未开通

失败自动退款。提交被拒、上游失败、超时或任务进入 failed，已扣额度全额退回，不产生扣费。