豆包视频生成参数详解

概述

豆包视频生成 API 支持多种视频生成模式，包括文生视频、图生视频（首帧/首尾帧）和参考图生视频。基于火山引擎的先进 AI 模型，能够生成高质量的视频内容。

接口信息

请求地址： POST /v1/tasks/generations

内容类型： application/json

认证方式： Bearer Token

请求头示例：

模型能力

支持的模型

模型名称	模型 ID	支持功能
Seedance Pro	`bytedance/doubao-seedance-1.0-pro`	文生视频、首帧图生视频
Seedance Lite T2V	`bytedance/doubao-seedance-1.0-lite-t2v`	文生视频
Seedance Lite I2V	`bytedance/doubao-seedance-1.0-lite-i2v`	首帧图生视频、首尾帧图生视频、参考图生视频

参数说明

基础参数

参数名	类型	必填	默认值	描述	限制
`model`	string	✅	-	模型 ID	见支持的模型列表
`prompt`	string	✅	-	文本提示词	≤500字符，支持中英文

视频生成参数

参数名	类型	必填	默认值	描述	取值范围
`resolution`	string	❌	720p	视频分辨率	`480p`, `720p`, `1080p`
`ratio`	string	❌	16:9	视频宽高比	见宽高比说明
`duration`	int	❌	5	视频时长（秒）	Seedance: 3-12秒，Wan2.1: 5秒
`fps`	int	❌	24	视频帧率	`16`, `24`
`watermark`	bool	❌	false	是否添加水印	`true`, `false`
`seed`	int	❌	-1	随机种子	-1 到 2^31-1
`camera_fixed`	bool	❌	false	是否固定摄像头	`true`, `false`

图像相关参数

首帧图生视频

参数名	类型	必填	默认值	说明
`image`	string	✅	-	首帧图像（URL/Base64）
`image_role`	string	❌	first_frame	图片角色

首尾帧图生视频

参数名	类型	必填	默认值	说明
`image`	string	✅	-	首帧图像
`image_tail`	string	✅	-	尾帧图像
`image_role`	string	❌	first_frame	首帧角色
`image_tail_role`	string	❌	last_frame	尾帧角色

参考图生视频

参数名	类型	必填	默认值	说明
`image_list`	array	✅	-	参考图片数组（1-4张）
`image_list[i].image`	string	✅	-	图片 URL 或 Base64
`image_list[i].role`	string	❌	reference_image	图片角色

文本命令参数

除了通过请求体字段设置参数，也可以在提示词后可以追加 --[参数] 格式的文本命令来控制视频输出规格：

参数	简写	示例	说明
resolution	rs	`--rs 1080p`	设置分辨率
ratio	rt	`--rt 16:9`	设置宽高比
duration	dur	`--dur 10`	设置时长（秒）
fps	fps	`--fps 24`	设置帧率
watermark	wm	`--wm true`	是否加水印
seed	seed	`--seed 12345`	设置随机种子
camera_fixed	cf	`--cf true`	是否固定摄像头

示例:

一只可爱的小猫在花园里追逐蝴蝶 --rs 1080p --rt 16:9 --dur 10 --fps 24 --wm false

参数详细说明

分辨率 (resolution)

值	说明	支持模型
`480p`	480p 分辨率	所有模型
`720p`	720p 分辨率（默认）	所有模型
`1080p`	1080p 分辨率	所有模型（参考图场景不支持）

宽高比 (ratio)

值	说明	480p 像素值	720p 像素值	1080p 像素值
`16:9`	横屏（默认）	864×480	1248×704	1920×1088
`4:3`	传统比例	736×544	1120×832	1664×1248
`1:1`	正方形	640×640	960×960	1440×1440
`3:4`	竖屏比例	544×736	832×1120	1248×1664
`9:16`	手机竖屏	480×864	704×1248	1088×1920
`21:9`	超宽屏	960×416	1504×640	2176×928
`keep_ratio`	保持原图比例	自适应	自适应	自适应
`adaptive`	自动选择最佳比例	自适应	自适应	自适应

注意: keep_ratio 仅 Wan2.1 模型支持；adaptive 为 Seedance Pro 图生视频和 Lite I2V 首帧/首尾帧图生视频默认值。

图片要求

项目	要求
格式	JPEG、PNG、WebP、BMP、TIFF、GIF
大小	≤ 30MB
分辨率	宽高在 300-6000px 之间
宽高比	在 0.4-2.5 之间
编码	URL 或 Base64（格式：`data:image/<格式>;base64,<编码>`）

请求示例

文生视频

基础文生视频

{
  "model": "bytedance/doubao-seedance-1.0-pro",
  "prompt": "一只可爱的小猫在花园里追逐蝴蝶，阳光明媚，画面温馨",
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 10,
  "fps": 24
}

使用文本命令的文生视频

{
  "model": "bytedance/doubao-seedance-1.0-pro",
  "prompt": "壮观的山脉景色，云雾缭绕，日出时分 --rs 720p --rt 16:9 --dur 8 --fps 24 --wm false --seed 12345"
}

首帧图生视频

URL 图片生成视频

{
  "model": "bytedance/doubao-seedance-1.0-pro",
  "image": "https://example.com/input.jpg",
  "image_role": "first_frame",
  "prompt": "让图片中的人物微笑并轻轻点头",
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 10,
  "fps": 24
}

Base64 图片生成视频

{
  "model": "bytedance/doubao-seedance-1.0-lite-i2v",
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...",
  "prompt": "让风景图片中的云朵流动起来 --rs 720p --rt adaptive --dur 8",
  "watermark": false
}

首尾帧图生视频

{
  "model": "bytedance/doubao-seedance-1.0-lite-i2v",
  "image": "https://example.com/start.jpg",
  "image_tail": "https://example.com/end.jpg",
  "image_role": "first_frame",
  "image_tail_role": "last_frame",
  "prompt": "从起始状态平滑过渡到结束状态",
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 10,
  "fps": 24
}

参考图生视频

多张参考图生成视频

{
  "model": "bytedance/doubao-seedance-1.0-lite-i2v",
  "image_list": [
    {
      "image": "https://example.com/image1.jpg",
      "role": "reference_image"
    },
    {
      "image": "https://example.com/image2.jpg",
      "role": "reference_image"
    },
    {
      "image": "https://example.com/image3.jpg",
      "role": "reference_image"
    }
  ],
  "prompt": "[图1]的老爷爷在[图3]的咖啡馆里，端起[图2]的咖啡杯，画面风格卡通、清新",
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10,
  "fps": 24
}

豆包视频生成参数详解

概述#

接口信息#

模型能力#

支持的模型#

参数说明#

基础参数#

视频生成参数#

图像相关参数#

首帧图生视频#

首尾帧图生视频#

参考图生视频#

文本命令参数#

参数详细说明#

分辨率 (resolution)#

宽高比 (ratio)#

图片要求#

请求示例#

文生视频#

基础文生视频#

使用文本命令的文生视频#

首帧图生视频#

URL 图片生成视频#

Base64 图片生成视频#

首尾帧图生视频#

参考图生视频#

多张参考图生成视频#

概述

接口信息

模型能力

支持的模型

参数说明

基础参数

视频生成参数

图像相关参数

首帧图生视频

首尾帧图生视频

参考图生视频

文本命令参数

参数详细说明

分辨率 (resolution)

宽高比 (ratio)

图片要求

请求示例

文生视频

基础文生视频

使用文本命令的文生视频

首帧图生视频

URL 图片生成视频

Base64 图片生成视频

首尾帧图生视频

参考图生视频

多张参考图生成视频