豆包 Seedance 视频生成 · 概述

文档版本：v1.0.0 | 最后更新：2026-06-11
本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。

能力简介

豆包 Seedance 视频生成支持以下任务类型，均通过同一个创建接口 POST /seedance/api/v3/contents/generations/tasks 提交，由 model 与 content 数组中的内容类型区分场景：

任务类型	关键入参	支持模型
文生视频（T2V）	`content` 中仅含 `text`	全系列
图生视频-首帧（I2V）	`content` 中含 `image_url`（`role=first_frame`）	全系列
图生视频-首尾帧（FL2V）	`content` 中含 `image_url`（`role=first_frame` + `role=last_frame`）	2.0 系列、1.5 pro、1.0 pro
多模态参考（Multimodal Reference）	`content` 中含参考图片/视频/音频	仅 2.0 系列
有声视频	`generate_audio=true`	2.0 系列、1.5 pro
样片模式（Draft）	`draft=true`	仅 1.5 pro

视频生成为异步任务：提交后立即返回 id（任务 ID），需通过查询接口轮询任务状态；任务成功后响应中直接包含 content.video_url（视频下载地址），无需单独调用下载接口。

标准调用流程

创建任务 (POST /seedance/api/v3/contents/generations/tasks)
        │  返回 id（任务 ID，7 天有效）
        ▼
查询状态 (GET /seedance/api/v3/contents/generations/tasks/{id})   ← 轮询直至 succeeded 或 failed
        │  返回 content.video_url（24 小时有效）
        ▼
下载 MP4 视频文件

接口地址

接口	方法	地址
创建视频生成任务	`POST`	`https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks`
查询视频生成任务	`GET`	`https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id}`
查询视频生成任务列表	`GET`	`https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks?page_num=...&page_size=...`
取消或删除视频生成任务	`DELETE`	`https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks/{id}`

路径规则：在平台域名后追加渠道前缀 /seedance，再拼接豆包 Seedance 官方原始路径即可。
例如官方 https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks → 平台 https://studio.dataeyes.ai/seedance/api/v3/contents/generations/tasks。

鉴权

所有请求均通过 HTTP Authorization 头携带 Bearer 密钥进行鉴权：

Authorization: Bearer {API_KEY}

{API_KEY} 为您在 DataEyes 控制台创建的接口密钥。

请求头

头部	必填	说明
`Authorization`	是	`Bearer {API_KEY}`
`Content-Type`	是	固定为 `application/json`（创建任务接口）

特色功能

功能	说明	适用模型
有声视频（`generate_audio`）	生成视频同时自动配音，默认开启	2.0 系列、1.5 pro
样片模式（`draft`）	快速生成低成本样片，确认效果后再正式生成	仅 1.5 pro
自适应比例（`ratio=adaptive`）	根据输入图片自动推断最佳画面比例	2.0 系列、1.5 pro
工具调用（`tools`）	支持 `web_search` 等工具增强生成效果	仅 2.0 系列
优先级（`priority`）	指定任务优先级 [0, 9]，数值越大优先级越高	仅 2.0 系列
回调通知（`callback_url`）	任务状态变更时主动推送回调	全系列

模型概览

模型	T2V	I2V 首帧	I2V 首尾帧	多模态参考	有声视频	样片模式	默认分辨率	时长范围
`doubao-seedance-2-0-v2-250528`	✅	✅	✅	✅	✅	—	720p	4–15s 或 -1
`doubao-seedance-2-0-fast-250528`	✅	✅	✅	✅	✅	—	720p	4–15s 或 -1
`doubao-seedance-1-5-pro-251215`	✅	✅	✅	—	✅	✅	720p	4–12s 或 -1
`doubao-seedance-1-0-pro-250401`	✅	✅	✅	—	—	—	1080p	2–12s
`doubao-seedance-1-0-pro-fast-250401`	✅	✅	—	—	—	—	1080p	2–12s

任务状态值

状态	含义
`queued`	排队中
`running`	生成中
`succeeded`	生成成功
`failed`	生成失败
`cancelled`	已取消
`expired`	已过期

00-概述

豆包 Seedance 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

特色功能

模型概览

任务状态值

相关文档

00-概述

豆包 Seedance 视频生成 · 概述#

能力简介#

标准调用流程#

接口地址#

鉴权#

请求头#

特色功能#

模型概览#

任务状态值#

相关文档#

豆包 Seedance 视频生成 · 概述

能力简介

标准调用流程

接口地址

鉴权

请求头

特色功能

模型概览

任务状态值

相关文档