01-创建视频生成任务
创建视频生成任务
文档版本：v1.0.0 | 最后更新：2026-06-11 本平台已完整适配豆包 Seedance 系列官方视频生成接口，请求与响应均为透传，参数语义与官方一致。
content 数组提交文本、图片、视频、音频等内容，创 建视频生成任务。POST https://cloud.ve2s.ai/seedance/api/v3/contents/generations/tasks请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | 模型 ID 或推理接入点 ID。可用值见模型概览 |
content | object[] | 是 | — | 多模态内容数组，支持 text、image_url、video_url、audio_url、draft_task 五种类型，详见下方 Content 对象类型 |
callback_url | string | 否 | — | 任务状态变更时的回调通知地址 |
return_last_frame | boolean | 否 | false | 是否在结果中返回视频末帧图片 URL |
service_tier | string | 否 | "default" | 推理服务层级。"default"（在线推理）或 "flex"（弹性推理）。2.0 系列仅支持 "default" |
execution_expires_after | integer | 否 | 172800 | 任务超时时间（秒），范围 [3600, 259200] |
generate_audio | boolean | 否 | true | 是否同时生成音频（有声视频）。仅 2.0 系列及 1.5 pro 支持 |
draft | boolean | 否 | false | 是否为样片模式（低成本快速预览）。仅 1.5 pro 支持 |
tools | object[] | 否 | — | 工具列表，如 [{"type": "web_search"}]。仅 2.0 系列支持 |
safety_identifier | string | 否 | — | 终端用户标识，用于安全审计 |
priority | integer | 否 | 0 | 任务优先级，范围 [0, 9]，数值越大优先级越高。仅 2.0 系列支持 |
resolution | string | 否 | 见下表 | 视频分辨率。可用值：480p、720p、1080p |
ratio | string | 否 | 见下表 | 画面比例。可用值：16:9、4:3、1:1、3:4、9:16、21:9、adaptive |
duration | integer | 否 | 5 | 视频时长（秒），与 frames 二选一。范围因模型而异（见下表）；-1 表示自动推断 |
frames | integer | 否 | — | 视频帧数，与 duration 二选一。范围 [29, 289]，公式：25 + 4n。2.0 系列及 1.5 pro 不支持 |
seed | integer | 否 | -1 | 随机种子，范围 [-1, 2^32-1]。-1 表示随机 |
camera_fixed | boolean | 否 | false | 是否固定镜头（参考图片场景时使用）。2.0 系列不支持 |
watermark | boolean | 否 | false | 是否添加水印 |
分辨率 / 比例 / 时长对照
| 模型 | 默认分辨率 | 可选分辨率 | 默认比例 | 时长范围 |
|---|---|---|---|---|
doubao-seedance-2-0-v2-250528 | 720p | 480p、720p | adaptive | [4, 15] 或 -1 |
doubao-seedance-2-0-fast-250528 | 720p | 480p、720p | adaptive | [4, 15] 或 -1 |
doubao-seedance-1-5-pro-251215 | 720p | 480p、720p、1080p | adaptive | [4, 12] 或 -1 |
doubao-seedance-1-0-pro-250401 | 1080p | 480p、720p、1080p | 16:9 | [2, 12] |
doubao-seedance-1-0-pro-fast-250401 | 1080p | 480p、720p、1080p | 16:9 | [2, 12] |
Content 对象类型
content 数组中每个元素为一个 Content 对象，通过 type 字段区分类型。Text（文本描述）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 固定为 "text" |
text | string | 是 | 视频文本描述（prompt） |
Image（图片）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 固定为 "image_url" |
image_url.url | string | 是 | 图片地址（URL、Base64 或素材 ID） |
image_url.role | string | 是 | 图片角色：first_frame（首帧）、last_frame（末帧）、reference_image（参考图片，仅 2.0 系列） |
Video（视频）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 固定为 "video_url" |
video_url.url | string | 是 | 视频地址（URL 或素材 ID） |
video_url.role | string | 是 | 固定为 reference_video（参考视频，仅 2.0 系列） |
Audio（音频）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 固定为 "audio_url" |
audio_url.url | string | 是 | 音频地址（URL、Base64 或素材 ID） |
audio_url.role | string | 是 | 固定为 reference_audio（参考音频，仅 2.0 系列） |
Draft Task（样片任务）
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
type | string | 是 | 固定为 "draft_task" |
draft_task.id | string | 是 | 样片任务 ID（仅 1.5 pro） |
各模型支持的场景
| 场景 | 2.0 v2 | 2.0 fast | 1.5 pro | 1.0 pro | 1.0 pro fast |
|---|---|---|---|---|---|
| 文生视频（T2V） | ✅ | ✅ | ✅ | ✅ | ✅ |
| 图生视频-首帧（I2V） | ✅ | ✅ | ✅ | ✅ | ✅ |
| 图生视频-首尾帧（FL2V） | ✅ | ✅ | ✅ | ✅ | — |
| 多模态参考 | ✅ | ✅ | — | — | — |
多模态参考：2.0 系列支持在 content中同时传入参考图片（0–9 张）、参考视频（0–3 个）、参考音频（0–3 个）以及文本描述。
素材要求
图片
| 约束项 | 要求 |
|---|---|
| 格式 | jpeg / png / webp / bmp / tiff / gif（1.5 pro 及 2.0 系列另支持 heic / heif） |
| 宽高比 | [0.4, 2.5] |
| 像素尺寸 | [300, 6000] px（宽和高均需在此范围内） |
| 文件大小 | < 30 MB |
视频（仅 2.0 系列参考视频）
| 约束项 | 要求 |
|---|---|
| 格式 | mp4 / mov |
| 编码 | H.264 / H.265 |
| 分辨率 | 480p – 1080p |
| 单个时长 | [2, 15] 秒 |
| 总数量 | 最多 3 个，总时长 ≤ 15 秒 |
| 文件大小 | ≤ 50 MB |
音频（仅 2.0 系列参考音频）
| 约束项 | 要求 |
|---|---|
| 格式 | wav / mp3 |
| 单个时长 | [2, 15] 秒 |
| 总数量 | 最多 3 个，总时长 ≤ 15 秒 |
| 文件大小 | ≤ 15 MB |
请求示例
文生视频（T2V）
图生视频-首帧（I2V）
图生视频-首尾帧（FL2V）
响应示例
{
"id": "cgt-20250611100000-abcde"
}响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | string | 视频生成任务 ID，有效期 7 天。用于查询任务状态及取消/删除任务 |
后续步骤：拿到 id后，通过查询接口轮询任务状态，建议轮询间隔不低于 10 秒，直至状态为succeeded或failed。
修改于 2026-07-21 07:53:31