Seedance 2.5

Seedance 2.5 的 4–30 秒时长、多参考素材规则、480p/720p 和请求示例

seedance-2.5 是 Seedance 的 2.5 渠道，支持 480p / 720p，可生成 4–30 秒视频，并提供更高的参考素材上限（最多 30 张图、10 条视频、3 条音频）。适合需要更长成片、多模态参考的视频任务。

2.5 还是 2.0？

需要更长时长（最高 30 秒）或更多参考素材时使用本模型；固定 15 秒、质量优先可用 seedance-2.0，常规 4–15 秒、速度优先可用 seedance-2.0-fast。本模型和 Fast 都支持 480p / 720p；seedance-2.0 仅 720p / 15 秒，且不支持首尾帧。

快速了解

项目	支持范围
任务流程	`POST /v1/task/submit` 提交，`GET /v1/task/{id}` 查询（兼容 `/v1/videos`）
视频时长	4–30 秒
清晰度	`480p` / `720p`，默认 `720p`
画面比例	`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
参考图	最多 30 张
参考视频	最多 10 条
参考音频	最多 3 条
首/尾帧	各最多 1 张；尾帧必须同时有首帧
人脸参考素材	支持
生成数量	固定 `n = 1`
音频生成	支持，默认开启

请求使用 Bearer 认证，生成参数统一放在 input 对象中：

Authorization: Bearer $API_KEY
Content-Type: application/json

input 参数

字段	类型	必填	说明
`prompt`	string	是	视频提示词，最多 5000 个字符。上游要求绑定已提交素材，可用 `@Image1` / `@Video1` / `@Audio1`
`duration`	integer	是	4–30 秒；也可传 `seconds`
`aspect_ratio`	string	是	`21:9`、`16:9`、`4:3`、`1:1`、`3:4`、`9:16`
`resolution`	string	否	默认 `720p`，可传 `480p`
`audio`	boolean	否	是否生成配乐，默认 `true`。兼容 `generate_audio` / `generateAudio`
`seed`	integer	否	传入后会被忽略，不建议传
`image_references`	array	否	参考图，最多 30 张
`video_references`	array	否	参考视频，最多 10 条
`audio_references`	array	否	参考音频，最多 3 条
`start_frames`	array	否	首帧，最多 1 张
`end_frames`	array	否	尾帧，最多 1 张；不能单独使用，必须同时传 `start_frames`
`n`	integer	否	生成数量，当前只支持 `1`

请使用 image_references / start_frames，不要用 input.images。

媒体输入格式

数组项使用可公开访问的 http(s) URL 字符串：

"https://example.com/a.jpg"

不支持本地路径。参考视频建议使用 mp4 / mov。参考素材中的 strength 传入后会被忽略，不建议传。

素材组合规则

组合	是否支持	说明
纯文生视频	支持	不传任何参考素材
参考图 / 参考视频 / 参考音频	支持	可组合使用
首帧	支持	只传 `start_frames[0]`
首帧 + 尾帧	支持	同时传 `start_frames[0]` 和 `end_frames[0]`
单独尾帧	不支持	`end_frames` 必须搭配 `start_frames`
首/尾帧 + 参考素材	不支持	与 `image_references`、`video_references`、`audio_references` 互斥

输出尺寸

默认 720p。传入 480p 时按所选清晰度输出。

aspect_ratio	720p
`21:9`	`1470x630`
`16:9`	`1280x720`
`4:3`	`1112x834`
`1:1`	`960x960`
`3:4`	`834x1112`
`9:16`	`720x1280`

请求示例

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "input": {
      "prompt": "海边日落，无人机缓慢推进，电影感",
      "duration": 12,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "audio": true
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "input": {
      "prompt": "让 @Image1 中的角色按 @Video1 的动作在场景中行走，并匹配 @Audio1 的节奏",
      "duration": 10,
      "resolution": "720p",
      "aspect_ratio": "9:16",
      "audio": true,
      "image_references": [
        "https://example.com/char.jpg"
      ],
      "video_references": [
        "https://example.com/motion.mp4"
      ],
      "audio_references": [
        "https://example.com/bgm.mp3"
      ]
    }
  }'

curl https://cdn.12ai.org/v1/task/submit \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "input": {
      "prompt": "从首帧平滑过渡到尾帧，镜头缓慢推进",
      "duration": 8,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "start_frames": ["https://example.com/start.jpg"],
      "end_frames": ["https://example.com/end.jpg"]
    }
  }'

获取结果

提交成功后保存返回的 id，再用它查询任务：

curl https://cdn.12ai.org/v1/task/task_xxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer $API_KEY"

`status`	含义
`queued`	排队中
`in_progress`	生成中
`completed`	完成，结果在 `outputs`（视频 URL 列表）
`failed`	失败，见 `error`

完成示例：

{
  "id": "task_xxxxxxxxxxxxxxxx",
  "status": "completed",
  "outputs": [
    "https://img.12ai.org/videos/task_xxxxxxxxxxxxxxxx_0.mp4"
  ]
}

建议间隔 3–5 秒轮询，直到 completed 或 failed。若传了 callback_url，完成/失败时也会 POST 到回调地址。

轮询状态、失败处理和回调格式见异步视频任务。

使用建议

场景	建议
需要 16–30 秒成片	使用本模型
多图 / 多视频 / 多音频参考	使用本模型（上限明显高于 2.0）
绑定参考素材	提示词里用 `@Image1` / `@Video1` / `@Audio1` 指向已提交素材
固定 15 秒、质量优先	改用 `seedance-2.0`
常规 4–15 秒、速度优先	改用 `seedance-2.0-fast`
首尾帧	不要与 `image_references`、`video_references`、`audio_references` 混用

Seedance 2.5

On this page