Doubao · 图生视频

按输入素材选择生成方式，核对型号与媒体规格。

候选模型与规格

查看候选模型 ID 与规格

模型 ID	厂商	类型	说明	上下文窗口	最大输出 Token	媒体规格	价格	状态
`Doubao-Seedance-2.0`	Doubao	视频	文生视频、图生视频、多参考素材生成、编辑和延长	—	—	查看规格型号：`Doubao-Seedance-2.0` 生成方式：文生视频、图生视频、参考生视频、视频编辑、视频延长；分辨率：480P–1080P；时长：4–15 秒；参考素材上限：9 张图片、3 段视频、3 段音频；音频生成：支持	查看价格型号：`Doubao-Seedance-2.0` $0.0567 币种：USD；计价单位：秒起；页面折扣：8.5折；资料日期：2026-09-28 登录页面参考价登录模型广场展示价，含页面折扣；以当前账户价格和账单为准。	—
`Doubao-Seedance-2.0-cloud`	Doubao	视频	文生视频、图生视频、续写、多素材参考和音画同步	—	—	查看规格型号：`Doubao-Seedance-2.0-cloud` 生成方式：文生视频、图生视频、参考生视频、视频延长；分辨率：最高 1080P；时长：4–30 秒；参考素材上限：9 张图片、3 段视频、3 段音频；音频生成：支持	查看价格型号：`Doubao-Seedance-2.0-cloud` $1.8550 币种：USD；计价单位：1M 输出 Tokens 起；页面折扣：8折；资料日期：2026-09-28 登录页面参考价登录模型广场展示价，含页面折扣；以当前账户价格和账单为准。	—
`Doubao-Seedance-2.0-fast`	Doubao	视频	文生视频、图生视频和音画同步	—	—	查看规格型号：`Doubao-Seedance-2.0-fast` 生成方式：文生视频、图生视频、参考生视频；分辨率：480P–1080P；时长：4–15 秒；音频生成：支持	查看价格型号：`Doubao-Seedance-2.0-fast` $0.0261 币种：USD；计价单位：秒起；页面折扣：5折；资料日期：2026-09-28 登录页面参考价登录模型广场展示价，含页面折扣；以当前账户价格和账单为准。	—
`Seedance-2.0-mini`	Doubao	视频	文生视频、图生视频、首尾帧和多素材参考	—	—	查看规格型号：`Seedance-2.0-mini` 生成方式：文生视频、图生视频、参考生视频；时长：4–15 秒；分辨率：最高 720P / 24fps；音频生成：支持	查看价格型号：`Seedance-2.0-mini` $0.0127 币种：USD；计价单位：秒起；页面折扣：3.8折；资料日期：2026-09-28 登录页面参考价登录模型广场展示价，含页面折扣；以当前账户价格和账单为准。	—

按公开标签归类，并补充模型广场资料；— 表示暂无明确资料。左右滑动查看完整表格。

媒体地址 https://example.com/… 是占位符，请替换为公开可下载且符合所选型号规格的素材。示例按接入资料整理，模型与通道依账户配置。

首帧 + 末帧 + 文

分别指定 first_frame 和 last_frame，生成起止画面之间的过渡。

Headers请求头

左右滑动查看完整参数表

请求头
参数名	类型	必填	说明	默认值 / 示例
`Authorization`	string	必填	平台 API Key，使用 Bearer 认证。	示例 `Bearer YOUR_API_KEY`
`Content-Type`	string	必填	JSON 请求体。	示例 `application/json`

Request Body请求体

application/json

左右滑动查看完整参数表

参数名类型必填说明默认值 / 示例

model

string

必填

平台完整模型 ID，区分大小写和后缀；六个平台接入例子使用 Doubao-Seedance-2.0-fast。

示例: Doubao-Seedance-2.0-fast

content

array

必填

平台 2.0 示例的输入内容数组；使用 content 写法时必须提供。已有 2.5 prompt/metadata 写法单独保留，勿机械合并。

—

content[] 的子字段 6

参数名类型必填说明默认值 / 示例

type

string

必填

单个内容项的模态，决定下方应填写的子字段。

可选值textimage_urlvideo_urlaudio_url

—

text

string

可选

type=text 时提供提示词；媒体场景按同类素材序号指代。

—

image_url

object

可选

当 type=image_url 时提供；url 需要可公开下载。

—

content[].image_url 的子字段 1

content[].image_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	对应模态的素材 URL；示例使用需替换的 example.com 占位地址。	—

video_url

object

可选

当 type=video_url 时提供；url 需要可公开下载。

—

content[].video_url 的子字段 1

content[].video_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	对应模态的素材 URL；示例使用需替换的 example.com 占位地址。	—

audio_url

object

可选

当 type=audio_url 时提供；url 需要可公开下载。

—

content[].audio_url 的子字段 1

content[].audio_url 子字段
参数名	类型	必填	说明	默认值 / 示例
`url`	string	必填	对应模态的素材 URL；示例使用需替换的 example.com 占位地址。	—

role

string

可选

用途角色：首尾帧和参考图按用途必填，视频和音频例子显式传齐。首尾帧与参考场景互斥。

可选值first_framelast_framereference_imagereference_videoreference_audio

—

duration

integer

可选

生成时长（秒）。平台接入例子为 4/5/8；官方 2.0 普通输出为 4–15 或 -1，2.5 为 4–30 或 -1，编辑另有条件。

示例: 4

resolution

string

可选

平台接入例子使用小写 480p/720p。官方 fast/mini 为 480p/720p，2.0 和 2.5 其他规格按型号核对。

示例: 480p

ratio

string

可选

平台接入例子使用 16:9。官方 2.5 的首帧、首尾帧、编辑、延长只允许 adaptive；平台映射按通道确认。

可选值16:94:31:13:49:1621:9adaptive

—

generate_audio

boolean

可选

平台接入文档中含视频或音频参考的例子在顶层传 true；官方默认 true，false 为无声输出。

示例: true

调用示例

curl --fail-with-body \
  --max-time 120 \
  --request POST \
  https://ai.kedang.net/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "Doubao-Seedance-2.0-fast",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "text",
      "text": "A cinematic reveal from still portrait to dynamic ending frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last-frame.jpg"
      },
      "role": "last_frame"
    }
  ],
  "duration": 8,
  "resolution": "720p",
  "ratio": "16:9"
}'

# pip install requests
import requests

url = 'https://ai.kedang.net/v1/video/generations'
headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}
payload = {'model': 'Doubao-Seedance-2.0-fast',
 'content': [{'type': 'image_url',
              'image_url': {'url': 'https://example.com/first-frame.jpg'},
              'role': 'first_frame'},
             {'type': 'text',
              'text': 'A cinematic reveal from still portrait to dynamic '
                      'ending frame'},
             {'type': 'image_url',
              'image_url': {'url': 'https://example.com/last-frame.jpg'},
              'role': 'last_frame'}],
 'duration': 8,
 'resolution': '720p',
 'ratio': '16:9'}

response = requests.request(
    'POST', url, headers=headers, timeout=120, json=payload
)
response.raise_for_status()
print(response.json())

// Node.js 18+ · 保存为 example.mjs 后运行

const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
const payload = {
  "model": "Doubao-Seedance-2.0-fast",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame"
    },
    {
      "type": "text",
      "text": "A cinematic reveal from still portrait to dynamic ending frame"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/last-frame.jpg"
      },
      "role": "last_frame"
    }
  ],
  "duration": 8,
  "resolution": "720p",
  "ratio": "16:9"
};

const response = await fetch("https://ai.kedang.net/v1/video/generations", {
  method: "POST",
  headers,
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify(payload),
});
if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`);
}
console.log(await response.json());

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"strings"
	"time")

func main() {
	payload := strings.NewReader("{\n  \"model\": \"Doubao-Seedance-2.0-fast\",\n  \"content\": [\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\n        \"url\": \"https://example.com/first-frame.jpg\"\n      },\n      \"role\": \"first_frame\"\n    },\n    {\n      \"type\": \"text\",\n      \"text\": \"A cinematic reveal from still portrait to dynamic ending frame\"\n    },\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\n        \"url\": \"https://example.com/last-frame.jpg\"\n      },\n      \"role\": \"last_frame\"\n    }\n  ],\n  \"duration\": 8,\n  \"resolution\": \"720p\",\n  \"ratio\": \"16:9\"\n}")
	req, err := http.NewRequest("POST", "https://ai.kedang.net/v1/video/generations", payload)
	if err != nil { log.Fatal(err) }
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{Timeout: 120 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()
	data, err := io.ReadAll(resp.Body)
	if err != nil { log.Fatal(err) }
	if resp.StatusCode >= 400 { log.Fatalf("%s: %s", resp.Status, data) }
	fmt.Println(string(data))
}

图 + 文：两张参考图：展开四语言示例

参考图约束角色和画面；reference_image 与首帧用途不同。

调用示例

curl --fail-with-body \
  --max-time 120 \
  --request POST \
  https://ai.kedang.net/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "Doubao-Seedance-2.0-fast",
  "content": [
    {
      "type": "text",
      "text": "一辆汽车乘风破浪，冲向悉尼歌剧院"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image-1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image-2.jpg"
      },
      "role": "reference_image"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
}'

# pip install requests
import requests

url = 'https://ai.kedang.net/v1/video/generations'
headers = {'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json'}
payload = {'model': 'Doubao-Seedance-2.0-fast',
 'content': [{'type': 'text', 'text': '一辆汽车乘风破浪，冲向悉尼歌剧院'},
             {'type': 'image_url',
              'image_url': {'url': 'https://example.com/reference-image-1.jpg'},
              'role': 'reference_image'},
             {'type': 'image_url',
              'image_url': {'url': 'https://example.com/reference-image-2.jpg'},
              'role': 'reference_image'}],
 'duration': 4,
 'resolution': '480p',
 'ratio': '16:9'}

response = requests.request(
    'POST', url, headers=headers, timeout=120, json=payload
)
response.raise_for_status()
print(response.json())

// Node.js 18+ · 保存为 example.mjs 后运行

const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
const payload = {
  "model": "Doubao-Seedance-2.0-fast",
  "content": [
    {
      "type": "text",
      "text": "一辆汽车乘风破浪，冲向悉尼歌剧院"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image-1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference-image-2.jpg"
      },
      "role": "reference_image"
    }
  ],
  "duration": 4,
  "resolution": "480p",
  "ratio": "16:9"
};

const response = await fetch("https://ai.kedang.net/v1/video/generations", {
  method: "POST",
  headers,
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify(payload),
});
if (!response.ok) {
  throw new Error(`${response.status}: ${await response.text()}`);
}
console.log(await response.json());

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"strings"
	"time")

func main() {
	payload := strings.NewReader("{\n  \"model\": \"Doubao-Seedance-2.0-fast\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"一辆汽车乘风破浪，冲向悉尼歌剧院\"\n    },\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\n        \"url\": \"https://example.com/reference-image-1.jpg\"\n      },\n      \"role\": \"reference_image\"\n    },\n    {\n      \"type\": \"image_url\",\n      \"image_url\": {\n        \"url\": \"https://example.com/reference-image-2.jpg\"\n      },\n      \"role\": \"reference_image\"\n    }\n  ],\n  \"duration\": 4,\n  \"resolution\": \"480p\",\n  \"ratio\": \"16:9\"\n}")
	req, err := http.NewRequest("POST", "https://ai.kedang.net/v1/video/generations", payload)
	if err != nil { log.Fatal(err) }
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{Timeout: 120 * time.Second}
	resp, err := client.Do(req)
	if err != nil { log.Fatal(err) }
	defer resp.Body.Close()
	data, err := io.ReadAll(resp.Body)
	if err != nil { log.Fatal(err) }
	if resp.StatusCode >= 400 { log.Fatalf("%s: %s", resp.Status, data) }
	fmt.Println(string(data))
}

单首帧原生结构参考

官方原生首帧用一张 image_url，role 可明确写 first_frame；2.5 首帧场景的 ratio 仅允许 adaptive。该结构的具体平台映射待确认。

展开官方原生 content 片段

{
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/first-frame.jpg"
      },
      "role": "first_frame"
    }
  ]
}

content 与素材用途

content 是内容项数组：文本用 type=text 与 text；媒体使用对应的 URL 对象和 role。

首帧、首尾帧和全模态参考是互斥场景；不在同一请求中混合 first_frame/last_frame 与 reference_image/reference_video/reference_audio。
首帧明确写 first_frame；首尾帧两项分别写 first_frame、last_frame；参考图必须写 reference_image，不能把参考图当成结构化首帧。
提示词按同类素材在数组中的出现顺序写“图片1”“视频1”“音频1”；不同模态各自编号，素材 ID 和名称不代替这些序号。
2.0 系列参考音频不能单独输入，至少同时提供一张参考图或一段参考视频；2.5 原生协议允许单独参考音频，其平台通道支持另行确认。

官方原生图片和音频支持公网 URL、对应模态的 Base64 Data URL 与 asset://ASSET_ID；视频只列公网 URL 和 Asset URI，不提供视频 Base64 示例。Asset URI 放在对应模态对象的 url 字段；其平台生成映射待确认。素材库管理与引用 →

官方媒体规格参考

以下是当前火山官方原生规格，不构成平台配额或所有通道的支持承诺；平台账户限制以对应型号和通道为准。

项目	Seedance 2.0 系列	Seedance 2.5
参考图片	0–9 张	0–30 张
参考视频	0–3 段；每段 2–15 秒，总时长 ≤15 秒	0–10 段；普通参考每段 2–30 秒，编辑每段 4–30 秒，总时长 ≤30 秒
参考音频	0–3 段；每段 2–15 秒，总时长 ≤15 秒	0–10 段；每段 2–30 秒，总时长 ≤30 秒
输出时长	整数 4–15 秒或 -1 智能选择	整数 4–30 秒或 -1；编辑只允许 -1
输出分辨率	2.0：480p/720p/1080p/4k；fast/mini：480p/720p	480p/720p/1080p
首帧／首尾帧／编辑／延长比例	支持型号允许的比例或 adaptive	仅 adaptive
总素材数量	按各模态上限分别核对	最多 50：30 图 + 10 视频 + 10 音频

输入	格式	官方限制
图片	jpeg/png/webp/bmp/tiff/gif；2.0 及以上另支持 heic/heif	宽高比 [0.4,2.5]；边长 [300,6000] px；单张 <30 MB
视频	mp4/mov；MP4 为 H.264/H.265 视频、AAC/MP3 音频，MOV 另支持 PCM	宽高比 [0.4,2.5]；边长 [300,6000] px；总像素 [407696,8295044]；24–60 FPS；单个 ≤200 MB
音频	wav/mp3	单个 ≤15 MB；数量和时长按上表区分型号

原生请求体不超过 64 MB。生成输入规格与素材库入库规格分别核对；素材已入库不代表满足每个视频模型的输入限制。

参考资料

核对日期：2026-10-12。平台请求依据平台接入示例；官方文档用于补充型号条件和原生协议说明。

平台接入示例 ↗ · 官方创建参数 ↗ · 官方任务查询 ↗ · 官方任务列表 ↗ · 官方取消与删除 ↗ · Seedance 2.0 教程 ↗ · Seedance 2.5 教程 ↗

素材引用

素材库管理与引用 →：用于支持虚拟人像素材引用的型号，具体生成字段以所选型号的接入格式为准。