豆包 Seedance 2 · 视频
文生视频NEW
📌 这是什么:用一句话描述生成一段视频。
💡 什么时候用:想凭文字创意直接出片时用。
接口地址
| 用途 | 方法 | 路径 |
|---|---|---|
| 提交任务 | POST | /api/cqt/generator/seedance2 |
| 查询结果 | GET | /api/cqt/info/seedance2?id={taskId} |
⏱ 建议轮询时间:视频出片较慢(约 1~4 分钟),建议每 15 秒轮询一次,直到 status = succeeded / failed。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | — | 固定 seedance2(缺省即此值) |
| prompt | string | 必填 | 视频描述 |
| seconds | integer | — | 时长(秒)4~15,默认 5(别名 duration) |
| resolution | string | — | 分辨率 480p / 720p,默认 720p(1080p 自动降级 720p) |
| ratio | string | — | 比例 auto / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16(与 size 二选一) |
| size | string | — | 像素尺寸,如 1280x720(与 ratio 二选一) |
| generateAudio | boolean | — | 是否生成音频,默认 false |
| seed | integer | — | 随机种子(可选) |
请求示例
curl -X POST https://api.cqtai.com/api/cqt/generator/seedance2 \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance2",
"prompt": "a cat surfing on a rainbow wave, cinematic",
"size": "1280x720",
"seconds": 15,
"resolution": "720p",
"ratio": "16:9",
"generateAudio": false
}'
# -> { "code":200, "data":"<taskId>" }响应示例
{
"code": 200,
"data": {
"id": "<taskId>",
"status": "succeeded",
"resultUrl": "https://.../result.mp4",
"createTime": "2026-06-15 10:00:00",
"completeTime": "2026-06-15 10:02:00"
}
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | 状态码,200 表示请求成功 |
| msg | string | 状态描述,成功为 success |
| data.id | string | 任务 ID(taskId),用于 GET /api/cqt/info 轮询查询 |
| data.status | string | 任务状态:succeeded 成功 / failed 失败 / 其余为处理中 |
| data.resultUrl | string | 生成结果的视频地址,status = succeeded 时返回;未完成或失败为 null |
| data.errorMsg | string | null | 失败原因;成功时为 null |
| data.createTime | string | 任务创建时间 |
| data.completeTime | string | null | 任务完成时间;未完成为 null |
计费与积分
5 积分 × 时长(秒)(× 你的用户费率)。任务失败自动退回。