Seedance — 原生格式

POST/contents/generations/tasks

调用 Seedance 原生 API 提交文生视频或图生视频任务。

Bearer Token

模型介绍

Seedance 是火山引擎豆包团队推出的视频生成模型，支持文生视频与图生视频，对中文 prompt、中国元素、人物动作的理解优秀。

支持模型

模型	时长	分辨率	帧率	说明
doubao-seedance-2-0	5s / 10s	720p / 1080p	24 fps	主力版本
doubao-seedance-2-0-mini	5s	720p	24 fps	经济版

端点概览

端点	方法	说明
/contents/generations/tasks	POST	提交生成任务
/contents/generations/tasks/{task_id}	GET	查询任务状态

请求参数

Seedance 请求参数

参数	类型	必填	默认值	描述
model	string	是	-	模型名称：doubao-seedance-2-0 / doubao-seedance-2-0-mini
content	array	是	-	内容数组，混合 text 与 image_url 类型元素
duration	string	否	5s	时长：5s / 10s（lite 仅 5s）
resolution	string	否	720p	分辨率：720p / 1080p
fps	integer	否	24	帧率，默认 24
seed	integer	否	随机	种子，用于结果复现
callback_url	string	否	-	任务回调地址

content 结构

type	字段	说明
text	text: string	文本描述
image_url	image_url: { url: string }	参考图 URL

请求示例

文生视频

curl -X POST /contents/generations/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0",
    "content": [{"type": "text", "text": "猫咪在草地上奔跑，阳光明媚"}],
    "duration": "5s",
    "resolution": "720p"
  }'

import requests

HEADERS = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

r = requests.post(
    "/contents/generations/tasks",
    headers=HEADERS,
    json={
        "model": "doubao-seedance-2-0",
        "content": [{"type": "text", "text": "猫咪在草地上奔跑，阳光明媚"}],
        "duration": "5s",
        "resolution": "720p",
    },
).json()
print(r["id"])  # task_id

图生视频

r = requests.post("/contents/generations/tasks", headers=HEADERS, json={
    "model": "doubao-seedance-2-0",
    "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/cat.png"}},
        {"type": "text", "text": "猫咪转头看向镜头"},
    ],
    "duration": "5s",
})

响应示例（火山官方结构）

提交响应

提交响应

{
  "id": "cgt-20260904153000-xxxx"
}

提交响应对齐火山官方：仅 id 一个字段（任务 ID，用于查询）。

查询响应（succeeded）

查询响应

{
  "id": "cgt-20260904153000-xxxx",
  "model": "doubao-seedance-2-0",
  "status": "succeeded",
  "content": {
    "video_url": "https://cdn.example.com/video.mp4?expires=86400&..."
  },
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  },
  "created_at": 1754389200,
  "updated_at": 1754389320
}

字段	说明
id	任务 ID
model	模型名
status	火山官方枚举：queued / running / succeeded / failed / cancelled
content.video_url	视频 URL（succeeded 后返回，有效期 24 小时（X-Tos-Expires=86400），每次查询重新签名）
usage	用量（completion_tokens / total_tokens，视频按秒折算 token）
error	失败时的错误信息（含 code/message）

本页为火山原生协议：status 枚举为火山官方（running/succeeded），与 OpenAI 兼容端点（/v1/video/generations，in_progress/completed）不同——两套端点各自保持原生语义，按所用端点的枚举处理。

注意事项

• 生成耗时通常 1~3 分钟。
• video_url 有效期 24 小时（X-Tos-Expires=86400），每次查询重新签名，请及时下载。
• 图生视频时，参考图必须为可访问的 URL 或 asset:// 素材引用。
• doubao-seedance-2-0-mini 仅支持 5s / 720p。
• 计费按时长（秒）×分辨率系数；usage 按秒折算 token。