Seedance 2.5 / 2.0 HMT

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
模型名: Seedance 2.5：不带参考视频 seedance-2.5-720p-hmt；带参考视频 seedance-2.5-ref-720p-hmt
Seedance 2.0：12 个模型见第 08 节
必填参数: model、prompt、duration（整数秒）
客户端超时: 建议轮询总超时 ≥ 600 秒

分辨率由模型名决定，不用传。Seedance 2.5 固定 720p；Seedance 2.0 按模型名里的分辨率出片。请求体里的 resolution 会被自动改成对应值。

02模型与价格（Seedance 2.5）

Seedance 2.0 的价格见第 08 节。Seedance 2.5 按出片秒数计费，单价 × 出片秒数 = 总价。价格单位为人民币元 / 秒。

模型名	任务类型	单价	4 秒	10 秒	30 秒
`seedance-2.5-720p-hmt`	不带参考视频（文生 / 首帧 / 首尾帧 / 参考图 / 参考音频）	¥0.88 / 秒	¥3.52	¥8.80	¥26.40
`seedance-2.5-ref-720p-hmt`	带参考视频（可同时带参考图 / 参考音频）	¥0.98 / 秒	¥3.92	¥9.80	¥29.40

按是否带参考视频选模型名。请求里有 reference_video 必须用 seedance-2.5-ref-720p-hmt，没有则必须用 seedance-2.5-720p-hmt；用错会直接返回 400，不扣费。

参考视频时长不另收费，只按出片秒数计。参考图、参考音频、生成有声视频也都不加价。

03计费方式

提交成功即按「单价 × 出片秒数」扣费；任务失败或超时自动全额退回。

情形	计费公式
`seedance-2.5-720p-hmt`（不带参考视频）	¥0.88 × 出片秒数
`seedance-2.5-ref-720p-hmt`（带参考视频）	¥0.98 × 出片秒数

出片秒数就是请求里的 duration（4 – 30 的整数）。

04参考素材规则

本节是 Seedance 2.5 的数量上限；图片规格要求两套模型通用。Seedance 2.0 的数量上限见第 08 节。

素材	上限
参考图	最多 30 张
参考视频	最多 10 个（仅 `seedance-2.5-ref-720p-hmt`）
参考音频	最多 10 段
只传参考音频	支持
首尾帧	支持
出片时长	4 – 30 秒

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

参考图 / 首尾帧图片规格

每一张图都要满足下表，任意一张不合格整单失败（自动退款）。提交前请自行检查并裁剪 / 缩放。

项目	要求
宽、高	都在 300 – 6000 像素之间
宽高比（宽 ÷ 高）	0.4 – 2.5（不能太长或太扁）
格式	建议 JPG / PNG / WEBP
大小	单张小于 30 MB

小图标、头像缩略图最容易踩坑。比如一张 199 × 199 的图，边长不足 300 像素就会整单失败。失败原因会写明是第几张参考图（如「参考图4：……」），见第 07 节。

05提交任务

5.1 请求格式

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

role	用途
`first_frame` / `last_frame`	首帧 / 尾帧（只传首帧即首帧图生视频）
`reference_image`	参考图（主体 / 风格 / 构图）
`reference_video`	参考视频（运镜 / 动作），须用 `seedance-2.5-ref-720p-hmt`
`reference_audio`	参考音频（节奏 / 环境声）

顶层参数：duration（必填，整数秒）、ratio（可选：16:9、4:3、1:1、3:4、9:16、21:9、adaptive）。要生成带声音的视频，在 metadata 里传 "generate_audio": true，不加价。

首帧 / 首尾帧任务不要传 ratio。这种模式下画幅固定跟随首帧图，传了 ratio 会被上游拒绝（任务失败、自动退款）。

其它模式下，不传 ratio 时本网关不代填默认值；带参考素材时画幅可能跟随素材。要锁定 16:9 等画幅，请显式传 ratio。

任务类型 `omni_reference_task_type`（Seedance 2.5）

带参考视频时，上游可能根据提示词把任务判成「视频编辑」。视频编辑的输出画幅和时长跟随原视频，这时传了 ratio 或 duration 会被拒，任务失败。为避免误判，本网关默认替你传 "omni_reference_task_type": "reference"（全模态参考），按你给的 ratio 和 duration 生成。一般不用管这个参数。

取值	含义
`reference`（默认）	全模态参考：参考图 / 视频 / 音频只作为参考，按请求里的 `ratio`、`duration` 出片
`auto`	由上游根据提示词自动判断任务类型，可能判成视频编辑而失败，不建议

如需自己指定，可放在请求体顶层，也可放在 metadata 里，二者都传时以 metadata 为准。Seedance 2.0 不用传这个参数。

暂不支持视频编辑 / 视频续写。这两种模式的时长由原视频决定，和按秒计费冲突，请勿传 edit、extend。

5.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-720p-hmt",
    "prompt": "霓虹都市夜景，镜头缓缓推进，雨后街道倒映灯光",
    "duration": 5,
    "ratio": "16:9"
  }'

5.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-hmt",
    "prompt": "从第一张图自然过渡到第二张图",
    "duration": 5,
    "metadata": {
      "content": [
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/first.png"},"role":"first_frame"},
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/last.png"},"role":"last_frame"}
      ]
    }
  }'

5.4 参考图 + 参考音频 + 有声

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-hmt",
    "prompt": "角色与图片1一致，动作节奏贴合音频1",
    "duration": 8,
    "ratio": "16:9",
    "metadata": {
      "content": [
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/char.png"},"role":"reference_image"},
        {"type":"audio_url","audio_url":{"url":"https://your-cdn.com/bgm.mp3"},"role":"reference_audio"}
      ],
      "generate_audio": true
    }
  }'

5.5 参考视频（用 seedance-2.5-ref-720p-hmt）

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-ref-720p-hmt",
    "prompt": "角色跟图片1一致，运镜跟视频1",
    "duration": 10,
    "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"}
      ]
    }
  }'

5.6 提交成功的响应

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

200 response

{
  "id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "task_id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "object": "video",
  "model": "seedance-2.5-720p-hmt",
  "status": "queued",
  "progress": 0,
  "created_at": 1791600000
}

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

06轮询与取片

用 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-720p-hmt",
  "status": "completed",
  "progress": 100,
  "created_at": 1791600000,
  "completed_at": 1791600160,
  "metadata": {
    "url": "https://video.example.com/xxxx.mp4"
  }
}

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

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

07错误处理

HTTP	典型信息	处理
404	bad response status code 404	用了 `/v1/chat/completions`，改用 `POST /v1/videos`
400	duration 不在允许范围	Seedance 2.5 为 4 – 30 秒，Seedance 2.0 为 4 – 15 秒，整数
400	`reference_video_not_allowed` / `reference_video_required`	模型名和参考视频不匹配：带参考视频用 `seedance-2.5-ref-720p-hmt`，不带用 `seedance-2.5-720p-hmt`
400	`too_many_reference_images` / `videos` / `audios`	减少素材数量，上限见第 04 节（2.5）/ 第 08 节（2.0）
400	`invalid_audio_only_input`	仅 Seedance 2.0：参考音频必须搭配至少一张参考图或一个参考视频
—	任务 `failed`：ratio is not valid … follows the first-frame image	首帧 / 首尾帧任务去掉 `ratio`
—	任务 `failed`：参考图尺寸不符合要求（300～6000 像素）	换图或放大 / 缩小后重提，规格见第 04 节
—	任务 `failed`：参考图宽高比不符合要求（0.4～2.5）	裁剪后重提
—	任务 `failed`：参考图格式不支持	改用 JPG / PNG / WEBP
—	任务 `failed`：素材下载失败	媒体 URL 需公网可直接下载
—	任务 `failed`：内容审核未通过 / 涉及真人	修改提示词或更换素材后重提
403	token quota is not enough	余额不足，充值或换令牌
503	No available channel	模型名拼错或令牌分组未开通

失败原因直接给你看。任务进入 failed 时，查询结果的 error.message 是中文说明，写明原因和改法；能定位到具体素材时会带前缀，如「参考图4：参考图尺寸不符合要求……」。把这段原样展示给你的用户即可，无需联系我们。

200 response · failed

{
  "id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
  "object": "video",
  "model": "seedance-2.5-720p-hmt",
  "status": "failed",
  "error": {
    "code": "...",
    "message": "参考图宽高比不符合要求：宽 ÷ 高要在 0.4～2.5 之间（图片不能太长或太扁），请裁剪后重试；reference image aspect ratio (width / height) must be between 0.4 and 2.5"
  },
  "metadata": { "url": "" }
}

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

08Seedance 2.0 / fast / mini（12 个模型）

接口、请求格式、轮询取片、错误处理与上文完全相同，只是模型名、时长、计费和素材上限不同。

8.1 模型名

和 Seedance 2.5 一样按是否带参考视频分两个名字：带参考视频的名字里多一个 ref。名字里就是成片分辨率，resolution 不用传。

版本	分辨率	不带参考视频	带参考视频
Seedance 2.0	720p	`seedance-2.0-720p-hmt`	`seedance-2.0-ref-720p-hmt`
Seedance 2.0	1080p	`seedance-2.0-1080p-hmt`	`seedance-2.0-ref-1080p-hmt`
Seedance 2.0 fast	720p	`seedance-2.0-fast-720p-hmt`	`seedance-2.0-fast-ref-720p-hmt`
Seedance 2.0 fast	1080p	`seedance-2.0-fast-1080p-hmt`	`seedance-2.0-fast-ref-1080p-hmt`
Seedance 2.0 mini	720p	`seedance-2.0-mini-720p-hmt`	`seedance-2.0-mini-ref-720p-hmt`
Seedance 2.0 mini	1080p	`seedance-2.0-mini-1080p-hmt`	`seedance-2.0-mini-ref-1080p-hmt`

按是否带参考视频选模型名。请求里有 reference_video 必须用带 ref 的名字，没有则必须用不带 ref 的名字；用错会直接返回 400（reference_video_required / reference_video_not_allowed），不扣费。首帧、首尾帧、参考图、参考音频都用不带 ref 的名字。

8.2 价格与计费

按出片秒数计费：单价 × duration = 总价，提交成功即扣，失败、超时自动全额退款。带参考视频与不带参考视频同价，参考视频时长不另收费。

版本	720p 单价	1080p 单价	720p · 10 秒	1080p · 10 秒
Seedance 2.0	¥0.75 / 秒	¥1.61 / 秒	¥7.50	¥16.10
Seedance 2.0 fast	¥0.60 / 秒	¥1.30 / 秒	¥6.00	¥13.00
Seedance 2.0 mini	¥0.37 / 秒	¥0.81 / 秒	¥3.70	¥8.10

8.3 参数与素材上限

项目	Seedance 2.0 / fast / mini
`duration`	4 – 15 秒整数，必填
`ratio`	16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive（首帧 / 首尾帧任务不要传）
参考图	最多 9 张
参考视频	最多 3 个
参考音频	最多 3 段，必须搭配至少一张参考图或一个参考视频，不支持只传音频
有声视频	`metadata.generate_audio: true`

图片规格要求同第 04 节。请求写法同第 05 节，把 model 换成 2.0 模型名即可。

8.4 示例：首帧图生视频，1080p 输出

curl

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast-1080p-hmt",
    "prompt": "人物转身走向窗边，镜头缓慢跟随",
    "duration": 10,
    "metadata": {
      "content": [
        {"type":"image_url","image_url":{"url":"https://your-cdn.com/first.png"},"role":"first_frame"}
      ],
      "generate_audio": true
    }
  }'

8.5 示例：参考图 + 参考视频，720p 输出（用带 ref 的名字）

curl

curl -X POST https://www.salpx.com/v1/videos \
  -H "Authorization: Bearer $SALPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-ref-720p-hmt",
    "prompt": "角色跟图片1一致，运镜跟视频1",
    "duration": 8,
    "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"}
      ]
    }
  }'

查询和取片与第 06 节相同，成片同样在 metadata.url。

01快速开始

02模型与价格（Seedance 2.5）

03计费方式

04参考素材规则

参考图 / 首尾帧图片规格

05提交任务

5.1 请求格式

任务类型 omni_reference_task_type（Seedance 2.5）

5.2 纯文生视频

5.3 首帧 / 首尾帧

5.4 参考图 + 参考音频 + 有声

5.5 参考视频（用 seedance-2.5-ref-720p-hmt）

5.6 提交成功的响应

06轮询与取片

07错误处理

08Seedance 2.0 / fast / mini（12 个模型）

8.1 模型名

8.2 价格与计费

8.3 参数与素材上限

8.4 示例：首帧图生视频，1080p 输出

8.5 示例：参考图 + 参考视频，720p 输出（用带 ref 的名字）

任务类型 `omni_reference_task_type`（Seedance 2.5）