视频生成

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

接口列表

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

提交任务

可用模型

具体可用模型 ID 与实时价格请以定价页面和 GET /v1/models 接口为准。

模型 ID	说明	计费方式
`doubao-seedance-2-0-260128`	Seedance 2.0（标准版）	按秒计费（分辨率 × 时长）
`doubao-seedance-2-0-fast-260128`	Seedance 2.0 Fast（快速版）	按秒计费（分辨率 × 时长）
`doubao-seedance-2.0`	Seedance 2.0（按 token 计费版）	按 token 计费（分辨率 × 是否含视频输入，二维定价）

纯文本生成视频

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": "vid-xxxxx", "status": "Queued"}, "error": null}

轮询任务状态

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

{
  "data": {
    "id": "vid-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）
OpenAI 视频格式（size 如 "1920x1080"，seconds 时长）

网关会自动识别格式并在内部统一处理，所有格式共用同一套计费逻辑：无论用哪种格式提交，分辨率都会被正确识别并用于计费（识别不到时按默认档计费），不会因格式不同而算错价。

计费说明

视频模型的实时单价请以定价页面与 GET /v1/models 接口为准，本文只说明计费方式。每次任务完成后，实际扣费金额在任务详情的 actual_cost 字段返回。

`doubao-seedance-2.0`（按 token 计费）

按 token 计费，采用 二维定价：计费单价由两个维度共同决定，网关会根据请求参数自动选择对应档位。

是否含视频输入：检查 reference_videos 数组是否有元素（含视频输入为更低单价的一档）。
分辨率：从 resolution 参数读取——480p / 720p 归为同一档，1080p 为更高的单独档位。未传 resolution 时默认按 720p 档计费。

最终费用 = 对应档位单价 × 本次消耗 token 数。四种组合（含/不含视频输入 × 720p/1080p 档）各有独立单价，具体数值见定价页面。

`doubao-seedance-2-0-*`（按秒计费）

按秒计费，单价由分辨率决定，费用 = 对应分辨率单价 × 视频时长（秒）。具体单价见定价页面。