生成控制台
描述画面，生成一段专属视频
渲染节点在线
队列 0
渲染监视器
STANDBY
待机
待机中
暂无渲染任务
00:00
720P · 30FPS
等待提示词
AI 视频引擎
-1 积分
16:9
最近任务
我的视频
共 0 条记录
积分充值
当前余额 0 积分
可用积分
0
生成规格
5s - 15s
画质档位
480P / 720P
卡密兑换
CARD
充值记录
充值记录与到账明细
| 时间 | 类型 | 积分 | 说明 |
|---|
API 管理
生成自己的 API Key，调用视频生成接口
生成我的 Key
KEY
名称（可选）
新 Key（仅显示一次）
我的 Key
| ID | 前缀 | 名称 | 状态 | 创建时间 | 操作 |
|---|
API 调用文档
DOCS
本文档同时适用于以下两个模型：
| 模型 | API 模型名 | 分辨率 | 时长 | 参考图片 |
|---|---|---|---|---|
| SD 2.0 | seedance-2.0 | 480p、720p | 4–15 秒任意整数 | 图像 |
| SD 2.0 Fast | seedance-2.0-fast | 480p、720p | 4–15 秒任意整数 | 图像 |
两个模型的请求格式完全相同，只需替换 model 值。
一、请求鉴权
Base URL: https://www.ccaicg.top/v1
Authorization: Bearer sk-...
Content-Type: application/json本平台限流：每分钟最多 10 次请求；同时最多 3 个生成任务。
二、两种请求格式
| 格式 | 创建接口 | 用途 |
|---|---|---|
| OpenAI 视频格式 | POST /v1/videos | 文生视频、单图生视频 |
| 多参考格式 | POST /v1/video/generations | 文生视频、图像参考 |
三、OpenAI 视频格式
3.1 SD 2.0 文生视频
curl -X POST "https://www.ccaicg.top/v1/videos" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "海边日落，镜头缓慢向前移动",
"seconds": 8,
"size": "720p",
"aspect_ratio": "16:9"
}'3.2 SD 2.0 Fast 文生视频
curl -X POST "https://www.ccaicg.top/v1/videos" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-fast",
"prompt": "海边日落，镜头缓慢向前移动",
"seconds": 8,
"size": "720p",
"aspect_ratio": "16:9"
}'3.3 单图生视频
curl -X POST "https://www.ccaicg.top/v1/videos" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "让画面产生自然动作，镜头缓慢推进",
"seconds": 6,
"size": "720p",
"aspect_ratio": "9:16",
"input_reference": {
"image_url": "https://example.com/image.jpg"
}
}'OpenAI 格式最多传入一张图片，使用 input_reference.image_url。
3.4 OpenAI 格式参数
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | seedance-2.0 或 seedance-2.0-fast |
prompt | 是 | 视频提示词 |
seconds | 否 | 4–15 秒整数，默认 6 秒 |
size | 否 | 分辨率或标准尺寸，默认 720p |
aspect_ratio | 否 | 16:9、4:3、3:4、1:1、21:9、9:16 |
input_reference.image_url | 否 | 单张参考图片的 HTTP(S) URL |
n | 否 | 批量任务数，默认 1 |
四、多参考格式
使用 image_references 传入参考图，最多 9 张。仅支持图片参考素材。
4.1 多参考请求示例
curl -X POST "https://www.ccaicg.top/v1/video/generations" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0-fast",
"prompt": "让图像1中的人物走向图像2中的建筑，保持人物特征与画面连贯",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_references": [
"https://example.com/image-1.jpg",
"https://example.com/image-2.jpg"
]
}'4.2 多参考格式参数
| 字段 | 必填 | 说明 |
|---|---|---|
model | 是 | seedance-2.0 或 seedance-2.0-fast |
prompt | 是 | 视频提示词 |
duration | 否 | 4–15 秒整数，默认 6 秒 |
resolution | 否 | 480p / 720p |
aspect_ratio | 否 | 16:9、4:3、3:4、1:1、21:9、9:16 |
image_references | 否 | 参考图片 HTTP(S) URL 数组，最多 9 张 |
n | 否 | 批量任务数，默认 1 |
五、没有公网素材 URL 时
在 input_reference 或 image_references 中使用上传声明：
{
"type": "upload",
"filename": "reference-file.ext",
"mime_type": "对应素材的 MIME 类型",
"size": 1234567
}根据素材类型替换 filename 和 mime_type，并把上传声明放入对应字段：
| 参考类型 | 放入字段 | 常用 mime_type |
|---|---|---|
| 图片 | input_reference 或 image_references | image/jpeg、image/png |
创建响应会返回 upload.slots。按每个槽位的 upload_url、upload_method 和 upload_headers 上传文件，然后确认：
curl -X POST "https://www.ccaicg.top/v1/uploads/complete" \
-H "Authorization: Bearer sk-..." \
-H "Content-Type: application/json" \
-d '{
"task_id": "TASK_xxx",
"status": "uploaded"
}'参考图片单文件最大 20MB，上传链接有效期为 2 分钟。使用 URL 时，素材地址必须是后端可直接访问的 HTTP(S) URL，不能依赖网页登录态或 Cookie。
六、查询任务
OpenAI 格式：
curl "https://www.ccaicg.top/v1/videos/VIDEO_ID" \
-H "Authorization: Bearer sk-..."多参考格式：
curl "https://www.ccaicg.top/v1/video/generations/TASK_ID" \
-H "Authorization: Bearer sk-..."OpenAI 格式完成状态为 completed，多参考格式完成状态为 succeeded。
七、获取成品
curl -L "https://www.ccaicg.top/v1/videos/VIDEO_ID/content" \
-H "Authorization: Bearer sk-..." \
-o result.mp4八、常见错误
| HTTP | 常见原因 |
|---|---|
| 400 | 模型、请求格式、时长、分辨率、比例或参考数量错误 |
| 401 | API Key 无效 |
| 404 | 模型或任务不存在 |
| 409 | 幂等键冲突或相同请求仍在处理 |
| 413 | 请求体或素材过大 |
| 429 | 请求过于频繁或并发已满 |
| 503 | 生成服务暂时不可用 |
建议为每次创建请求设置唯一的 Idempotency-Key，避免网络重试时重复创建任务。