Seedance 2.0 视频生成对接说明

统一走 CGAPI 的异步视频任务接口，覆盖文生、图生、多模态参考和首尾帧工作流。

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

适用场景

适合需要镜头控制、参考素材和 4 到 15 秒短视频的应用。模型 ID 使用 CGAPI 模型广场显示的精确大小写。

价格、可用分组和具体权限以模型广场及控制台消费记录为准，本页不写固定金额。

模型与公共参数

模型 ID	`seedance-2.0` `seedance-2.0-fast` `seedance-2.0-mini`
Endpoint	`POST /v1/videos`
必填	`model`、`prompt`
时长	`seconds` 使用 4 到 15 的整数秒
画面	`size` 按模型广场可选档位传入，例如 `1280x720`
参考素材	图像最多 9 张，视频最多 3 个，音频最多 3 个。素材 URL 需可被服务端访问，或按 multipart 方式上传。

提交任务

最小文生视频请求如下。图生和多模态请求在同一 JSON 中增加 images、videos、audios 数组；首尾帧按当前路由接受的首帧、尾帧字段传入。

curl --request POST "https://api2.cgapi.top/v1/videos" \
  --header "Authorization: Bearer <CGAPI_API_KEY>" \
  --header "Content-Type: application/json" \
  --data '{"model":"seedance-2.0","prompt":"黄昏海边的稳定跟拍，人物向镜头走来，电影质感，无文字。","seconds":6,"size":"1280x720"}'

import requests

response = requests.post("https://api2.cgapi.top/v1/videos", headers={"Authorization": "Bearer <CGAPI_API_KEY>"}, json={"model": "seedance-2.0", "prompt": "黄昏海边的稳定跟拍，人物向镜头走来，电影质感，无文字。", "seconds": 6, "size": "1280x720"}, timeout=60)
response.raise_for_status()
print(response.json())

轮询与下载

从创建响应读取 id 或 task_id。
按间隔请求 GET /v1/videos/{task_id}，直到状态为 completed 或明确失败。
完成后请求 GET /v1/videos/{task_id}/content，检查 Content-Type: video/* 并保存 MP4。

不要因为创建接口返回 HTTP 200 就判定成片成功，必须完成轮询和视频文件校验。

成功信号

创建响应包含可轮询的任务 ID。
任务状态进入 completed。
下载端点返回视频 MIME，文件头可识别为 MP4，并能被播放器打开。
控制台消费记录包含正确模型 ID 和所属分组。

常见问题

400：检查 seconds 是否为 4 到 15 的整数、素材数量和 URL 可达性。
401/403：检查 API Key、余额、所属分组和模型 ID 大小写。
任务长时间处理中：延长轮询窗口并记录任务 ID，不要重复提交同一付费请求。
首尾帧字段报错：保留公共字段，按该模型页返回的实际字段名调整，不要把其他供应商字段直接套用。