视频生成

使用 Seedance 2.0、Veo、Sora 等 AI 模型生成视频。API 采用异步提交 + 轮询的方式。

接口列表

方法	路径	说明
POST	/v1/videos/generations	提交视频生成任务
GET	/v1/videos/generations/:id	查询任务状态
GET	/v1/videos/generations	列出我的任务

提交任务

纯文本生成视频

POST /v1/videos/generations

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "一只金毛猎犬在阳光明媚的草地上奔跑，慢动作",
  "duration": 5,
  "aspect_ratio": "16:9",
  "generate_audio": false
}

多模态（带图片、视频、音频参考）

{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "第一人称视角的果茶广告...",
  "reference_images": [
    {"url": "https://example.com/tea1.jpg", "role": "reference_image"},
    {"url": "https://example.com/tea2.jpg", "role": "reference_image"}
  ],
  "reference_videos": [
    {"url": "https://example.com/ref.mp4", "role": "reference_video"}
  ],
  "reference_audios": [
    {"url": "https://example.com/bgm.mp3", "role": "reference_audio"}
  ],
  "duration": 11,
  "aspect_ratio": "16:9",
  "generate_audio": true
}

参数说明

参数	类型	默认值	说明
model	string	必填	视频模型 ID
prompt	string	必填	视频内容的文字描述
duration	number	5	视频时长（秒），范围 4–15
aspect_ratio	string	"16:9"	"16:9"、"9:16" 或 "1:1"
resolution	string	"720p"	"720p" 或 "1080p"
generate_audio	boolean	false	是否生成音轨
reference_images	array	[]	参考图片（最多 9 张）
reference_videos	array	[]	参考视频（最多 3 个）
reference_audios	array	[]	参考音频（最多 3 个）

提交响应

{"data": {"id": "cgt-20260406-xxxxx", "status": "Queued"}, "error": null}

轮询任务状态

GET /v1/videos/generations/cgt-20260406-xxxxx

{
  "data": {
    "id": "cgt-20260406-xxxxx",
    "model": "doubao-seedance-2-0-260128",
    "status": "Completed",
    "duration_seconds": 5,
    "actual_cost": 5.0094,
    "video_count": 1,
    "videos": [{"url": "https://..."}]
  }
}

任务状态说明

状态	说明
Queued	任务已提交，等待开始
Running	视频生成中
Completed	生成完成，视频 URL 可用
Failed	生成失败，查看 error_message 字段

格式兼容性

API 支持多种请求格式。除上方推荐的扁平格式外，还兼容：

• Seedance 原生格式（content 数组）
• Google Vertex 格式（instances + parameters）

网关会自动识别格式并在内部统一处理。