视频/创建任务

通过 Seedance 接口创建异步视频生成任务。

字节 Seedance / 创建任务

创建异步视频生成任务。

接口信息

项目值
方法POST
路径/api/v3/contents/generations/tasks
Base URLhttps://video.unigateway.ai
鉴权Authorization: Bearer $UNIGATEWAY_API_KEY

请求

curl https://video.unigateway.ai/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast",
    "content": [
      { "type": "text", "text": "一辆跑车在夜晚的霓虹街道上行驶，电影跟踪镜头。" }
    ],
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false
  }'

响应：

{
  "id": "cgt-20260514135903-68khw"
}

创建成功仅返回任务 id。最终视频结果需要通过 查询任务 接口获取。

请求参数

必填字段

字段类型说明
modelstringSeedance 模型 ID，例如 doubao-seedance-2.0-fast
contentarray至少包含一个输入项，支持 text 等类型

可选字段

字段类型示例说明
ratiostring"16:9"画幅比例
durationnumber5目标时长（秒）
generate_audiobooleanfalse是否生成音频
service_tierstring"standard"服务档位

不是所有模型变体都支持全部可选字段，使用前需单独验证。

参数校验规则

字段规则
model必须使用账号内真实可用的 Seedance 模型 ID
content至少包含一个受支持的输入项
ratio / duration取决于模型能力，需单独测试
generate_audio不是所有模型变体都支持

请求失败时，先移除所有可选字段，回到最小请求重新尝试。

常见失败场景

状态码原因处理
400字段结构不合法或参数不受支持移除可选字段，使用最小请求重试
401 / 403API Key 无效或权限不足检查凭证和账号权限
429触发频控或审核上限退避等待，将请求排队
5xx网关或上游服务异常使用封顶退避策略重试

Example request

Run it in your stack

Pick the SDK style that matches your app and copy the snippet directly into your project.

import requests

api_key = "<YOUR_UNIGATEWAY_API_KEY>"
base_url = "https://video.unigateway.ai"
headers = {
    "Authorization": "Bearer " + api_key,
    "Content-Type": "application/json",
}

resp = requests.post(
    base_url + "/api/v3/contents/generations/tasks",
    headers=headers,
    json={
        "model": "doubao-seedance-2.0-fast",
        "content": [{"type": "text", "text": "A cinematic city night drive."}],
        "ratio": "16:9",
        "duration": 5,
    },
)
resp.raise_for_status()
print(resp.json())