通过 Seedance 2.0 / Seedance 2.0 Fast 批量生成视频,支持 9 图 + 3 视频 + 3 音频参考素材,以及 480p / 720p 与 4-15 秒时长。
提交任务
提交 Seedance 2.0 / Seedance 2.0 Fast 批量视频生成任务,支持 9 图 + 3 视频 + 3 音频参考素材。
POST/api/third-party/videoGenerate/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证,用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 视频模型,传 seedance-2.0 或 seedance-2.0-fast。 |
| prompt | string | 是 | 视频生成提示词,描述镜头、动作、主体、背景与风格。 |
| images | string[] | 否 | 图片素材 URL 列表,最多 9 张。 |
| videos | string[] | 否 | 视频素材 URL 列表,最多 3 个。 |
| audios | string[] | 否 | 音频素材 URL 列表,最多 3 个。三方调用需传 mp3 或 wav;在线调试上传会自动转为 wav。 |
| resolution | string | 否 | 视频分辨率,可传 480p 或 720p。 |
| aspectRatio | string | 否 | 输出比例,如 auto、1:1、9:16、16:9。 |
| duration | number | 否 | 视频时长,4-15 秒。 |
| count | number | 否 | 每组输入生成条数;最终子任务数会乘以 count。 |
| watermark | boolean | 否 | 是否去字幕;开启后提示词会按视频生成页语义要求画面中不能出现字幕。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/videoGenerate/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.0",
"prompt": "用图片1的角色、图片2的场景,参考视频1的运镜和特效,再结合音频1的音色,生成一段新视频",
"images": [
"https://your-cdn.com/product-1.jpg",
"https://your-cdn.com/product-2.jpg"
],
"videos": [
"https://your-cdn.com/reference-video.mp4"
],
"audios": [],
"resolution": "720p",
"aspectRatio": "9:16",
"duration": 10,
"count": 1,
"watermark": false
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码,200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存,用于查询生成结果。 |
| data.recordId | string | - | 生成记录 ID,可用于问题排查和记录追踪。 |
| data.status | string | - | 任务初始状态,通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间,ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "视频生成任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"status": "pending",
"mode": "video",
"model": "seedance-2.0",
"totalTasks": 1,
"submittedTasks": 1,
"failedSubmissions": 0,
"estimatedTime": "60-180秒",
"cost": {
"unitCoins": 150,
"chargedCoins": 150,
"refundedCoins": 0
}
},
"timestamp": "2026-03-31T09:33:00.000Z"
}注意事项
- 视频生成使用独立接口,支持图片、视频、音频作为参考素材。
- Seedance 2.0 按分辨率和秒数计费:480p 为 7 积分/秒、720p 为 15 积分/秒;Fast 版本 480p 为 6 积分/秒、720p 为 13 积分/秒。
- 单次最多生成 200 个子任务,超出后建议拆批提交。
- 达到服务端并发提交上限时,子任务会进入等待队列;等待超时或队列满时返回 429,请稍后重试。
