Seedance 2.5 视频生成对接说明

模型广场同时提供即梦与字节跳动两套 Seedance 2.5 标识。两套都通过 CGAPI 异步视频任务接口接入，但参数规格不同，请先确认使用的模型 ID。

API Base URLhttps://api2.cgapi.top/v1查看模型广场

模型与公共参数

模型 ID	`seedance-2.5`（即梦，固定 720p / 30 秒） `Doubao-Seedance-2.5-720p` `Doubao-Seedance-2.5-1080p`（字节跳动，4-30 秒）
提交	`POST /v1/videos`，返回 `task_id` 与 `status: "queued"`
时长	字节跳动版本使用 `duration`，支持 4-30 秒任意整数；即梦版本固定 30 秒，不传时长参数。
画幅	字节跳动版本使用 `aspect_ratio`；即梦版本支持六种画幅，省略时按模型默认值处理。
参考上限	字节跳动版本单次最多 30 张图、10 段视频、10 段音频；即梦版本模型广场标注最多 30 张参考图。

具体价格与可用状态以模型广场实时展示为准；生成失败不计费。

提交任务

仅字节跳动 Doubao 版本支持纯文生视频，只需 model 与 prompt。即梦 seedance-2.5 不支持纯文生视频，必须至少提供 1 张参考图或 1 段参考视频；有参考素材时，在提示词中使用 @image1、@video1、@audio1 指向对应素材。

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"model":"Doubao-Seedance-2.5-720p","prompt":"夕阳下的海边，海浪缓缓拍打礁石，电影感宽镜头","duration":5,"aspect_ratio":"16:9"}'

即梦：必须提供参考图或参考视频

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"model":"seedance-2.5","prompt":"让参考图中的人物在城市天台日落时回头看向镜头，运镜平稳。","aspect_ratio":"16:9","reference_image_urls":["https://cdn.example.com/reference.jpg"]}'

单图或多图图生视频

image_url 是主图；追加 reference_image_urls 可使用多图。多角色场景可用 reference_images 传入 {"url":"...","name":"角色名"}，再在提示词写 @角色名。

{"model":"Doubao-Seedance-2.5-720p","prompt":"@image1 的人物在 @image2 的场景中缓步向前走","image_url":"https://cdn.example.com/person.jpg","reference_image_urls":["https://cdn.example.com/scene.jpg"],"duration":6,"aspect_ratio":"9:16"}

全能参考

可混合图片、视频和音频参考。使用视频或音频时，建议至少配 1 张主图。first_image_url 与 last_image_url 可用于首尾帧过渡。

{"model":"Doubao-Seedance-2.5-1080p","prompt":"@image1 的人物，动作参考 @video1，配合 @audio1 的节奏起舞，电影级光影","image_url":"https://cdn.example.com/person.jpg","reference_videos":["https://cdn.example.com/dance.mp4"],"reference_audios":["https://cdn.example.com/music.mp3"],"duration":8,"aspect_ratio":"16:9"}

素材必须是公网可直接下载的 http/https URL，或 data:image/...;base64,。不要使用需登录、临时授权或防盗链地址。reference_videos 最多 10 段，单段须不高于 1080p；reference_audios 最多 10 段。

轮询与下载

提交后保存 task_id。
每 5-10 秒请求 GET /v1/videos/{task_id}，直到 status 为 SUCCESS 或 FAILURE。
SUCCESS 后从返回体读取 video_url，直接 GET 下载 MP4。

curl "https://api2.cgapi.top/v1/videos/task_xxx" \
  --header "Authorization: Bearer <CGAPI_API_KEY>"
# {"status":"SUCCESS","video_url":"https://.../xxx.mp4"}

创建接口返回 HTTP 200 只代表任务已提交。需要等到终态并取得 video_url 后，才算成片成功。

约束与排错

字节跳动版本时长为 4-30 秒；即梦 seedance-2.5 固定 30 秒。
即梦 seedance-2.5 未提供参考图或参考视频时不支持提交。
字节跳动版本图片、视频、音频超过上限会被截断，请在客户端先控制数量。
参考素材必须是公网可直接下载的 URL 或 data URL。
参考内容应保持中性，敏感或侵权素材可能触发内容审核。
任务仍在处理中时继续轮询，避免对同一请求重复提交。