视频合成请求（汇总）

提示

headers 需要添加 "Bearer {{api_key}}" 用来认证
点击获取api_key

危险

视频生成API调用限速每分钟一次，若需提高速率请联系管理员或充值10元以上

统一入口：所有视频生成模型（豆包 Seedance 2.0、MiniMax、通义、Gemini 等）均通过此接口创建任务。

请求参数说明

字段	类型	必填	说明
model	string	是	模型名称，如 `doubao-seedance-2-0-260128`
prompt	string	否	视频描述文本提示词
function	string	是	生成模式：`text_to_video` / `multimodal_ref` / `first_frame` / `first_last_frame`
resolution	string	否	分辨率：`480p` / `720p` / `1080p`（fast 不支持 1080p）
ratio	string	否	宽高比：`adaptive` / `16:9` / `9:16` / `1:1` / `4:3` / `3:4` / `21:9`
duration	int	否	视频时长（秒），默认 5
seed	int	否	随机种子，-1 表示随机
generate_audio	bool	否	是否生成音频，默认 true
ref_images	file	否	参考图片（multimodal_ref 模式，1-9 张）
ref_video	file	否	参考视频（multimodal_ref 模式）
ref_audio	file	否	参考音频（multimodal_ref 模式）
first_frame	file	否	首帧图片（first_frame / first_last_frame 模式）
last_frame	file	否	尾帧图片（first_last_frame 模式）

响应示例

{
  "status": 201,
  "message": "",
  "data": {
    "category": "doubao_seedance2",
    "model": "doubao-seedance-2-0-260128",
    "task_id": "cgt-20260423171945-xnmrs"
  }
}

创建成功后，使用返回的 task_id 调用 任务数据获取 接口轮询状态。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "e3b2feb523ea4c8f92ff3e8993571acb",
    "category": "zhipu_ttv",
    "model": "cogvideox",
    "data": {
        "category": "zhipu_ttv",
        "model": "cogvideox",
        "task_id": "659317141095826768875820019259229702"
    }
}

视频合成请求（汇总）

请求参数说明#

响应示例#

请求参数

请求示例代码

返回响应

请求参数说明

响应示例