1. Seedance2文档
魔芋AI开发文档
  • API快速配置
    • CC-Switch快速配置(推荐)
    • Claude Code 与 Codex 安装配置
    • 智能体集成魔芋Skills
    • WorkBuddy 配置指南
    • TRAE Work 配置指南
    • AWS Quick Suite 配置指南
    • DeepSeek Harness (DSH) 配置指南
  • 魔芋SDK
    • SDK接口规范文档
    • SDK 完整示例
  • API文档
    • 文本接口
      • Anthropic 文本接口
      • 豆包文本接口
      • Gemini 文本接口
      • OpenAI 文本接口
      • 🖼️ DeepSeek-V4-Flash-Vision 视觉理解
      • 🖼️ GLM-5.3-Flash 多模态理解
      • rerank文本重排序 API 文档
    • 图片接口
      • 🎨 Doubao 图片接口
      • Seedream 图生图接口
      • Gemini 图片生成接口
      • GPT-Image-2 图片接口
      • MiniMax-Hailuo 图片接口
      • OpenAI 图片接口
      • Gemini 图生图调用示例
      • 即梦 & 生数异步图片接口
    • 视频接口
      • kling-v3-传入参考视频
      • 🎬 Kling-v3 系列视频接口
      • 豆包(Doubao)视频接口
      • Happy Horse 视频接口
      • 即梦视频接口
      • Kling 视频接口
      • Seedance 2.0 多图生视频调用示例
      • Sora 视频接口
      • Veo 视频生成 API 接口文档
      • MiniMax-H3 视频生成 API 文档
      • MiniMax-H3-Max 视频生成 API 文档
      • 🎬 Vidu 系列视频接口
      • wan万相 3.0 视频接口
      • Shuchuang 高清直出视频生成接口
      • 拍我AI PixVerse视频生成 API 文档
    • 语音接口
      • 🎙️ 豆包端到端实时语音接口
      • seed-audio-1.0语音合成 API 文档
      • MiniMax Speech API 文档
      • Mureka 音乐生成接口
  • API接口
    • 模型
      • 获取可用模型列表
    • 文本对话
      • OpenAI 对话补全
      • OpenAI Responses
      • Anthropic 消息接口
      • Gemini 内容生成
    • 图片生成
      • 图片编辑
      • 图片编辑 gpt-image
      • 图片生成
    • 视频生成
      • 提交视频生成任务
      • 查询视频生成任务
      • 按令牌获取视频任务列表
    • 素材库
      • 真人素材 API 接口文档(H5 人脸认证)
      • 创建素材 / 批量上传
      • 查询素材列表
      • 查询单个素材
      • 按批次查询素材
      • 更新素材名称
      • 删除素材
      • 获取素材库列表
      • 创建素材库
      • 删除素材库
      • 转移素材库
    • 素材管理
      • 素材管理 API 接口文档
      • 素材库自定义阿里云OSS教程
  • Seedance2文档
    • 豆包 Seedance 2.0 / 2.5 视频生成接口
    • 豆包 Seedance 2.5 草稿样片与正片 API 接口文档
    • 按令牌获取视频任务列表
    • 素材库 API 接口文档
  • 数据模型
    • ChatMessage
    • ChatCompletionRequest
    • ChatCompletionResponse
    • OpenAIUsage
    • ResponsesRequest
    • ResponsesResponse
    • AnthropicMessageRequest
    • AnthropicMessageResponse
    • GeminiPart
    • GeminiContent
    • GeminiGenerateContentRequest
    • GeminiGenerateContentResponse
    • ModelListResponse
    • ImageGenerationRequest
    • ImageGenerationResponse
    • SeedanceContentItem
    • SeedanceMetadata
    • VideoGenerationRequest
    • VideoTaskSubmitResponse
    • VideoTaskQueryResponse
    • VideoTaskListResponse
    • VideoTaskListItem
    • VideoAutoUploadRequest
    • VideoAutoUploadSubmitResponse
    • VideoFlatQueryResponse
    • AssetItem
    • CreateAssetRequest
    • CreateAssetResponse
    • ListAssetsRequest
    • ListAssetsResponse
    • GetAssetResponse
    • BatchGetAssetsResponse
    • AssetIdResponse
    • AssetGroupListResponse
    • ErrorResponse
  1. Seedance2文档

豆包 Seedance 2.0 / 2.5 视频生成接口

豆包 Seedance 2.0 / 2.5 系列视频生成接口文档,支持标准版、快速版、精简版与 2.5 版共 4 个模型:doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615、doubao-seedance-2-5-260628。

支持的模型#

模型名称说明支持分辨率
doubao-seedance-2-0-260128Seedance 2.0 标准版,画质更优,生成较慢(约 5-8 分钟)480p、720p、1080p、4k
doubao-seedance-2-0-fast-260128Seedance 2.0 快速版,速度更快(约 3-4 分钟),画质略低480p、720p
doubao-seedance-2-0-mini-260615Seedance 2.0 精简版,成本更低、速度更快,适合大批量生成480p、720p
doubao-seedance-2-5-260628Seedance 2.5,视频时长上限延长至 30 秒,素材上限提升至 50 个,原生多语言支持480p、720p、1080p
分辨率说明:仅 doubao-seedance-2-0-260128(标准版)支持 1080p 与 4k 高分辨率;doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615、doubao-seedance-2-5-260628 仅支持 480p 与 720p。详见下方 resolution 参数说明。
接口统一说明:以上模型使用基本相同的请求参数(metadata.content[] + metadata.ratio + metadata.duration),大多数场景下只需切换 model 字段即可切换模型;但各模型在分辨率、时长上限、素材数量等方面存在差异,doubao-seedance-2-5-260628 另有独立的智能控制行为,详见下方对应章节。

Seedance 2.5(doubao-seedance-2-5-260628)相较 2.0 系列的主要区别#

1.
更长时长:视频生成时长上限由 Seedance 2.0 系列的 15 秒延长至 30 秒,支持一次性生成长达 30 秒的连贯视频,无需多段拼接即可呈现完整故事。
2.
更多素材 + 纯音频参考:单次输入素材上限提升至 50 个(30 张图片 + 10 段视频 + 10 段音频),可自由组合图片、视频、音频等多模态素材。同时新增支持纯音频参考生成视频,无需搭配图片或视频素材。
3.
智能宽高比与时长:支持通过配置 ratio 为 adaptive、duration 为 -1 智能控制输出视频的宽高比和时长;但在视频编辑、视频延长、首帧或首尾帧生视频任务中具有特殊的控制行为,详见下方Seedance 2.5 智能控制行为。
4.
原生多语言生成:原生支持多种语言的提示词输入和有声视频生成,覆盖中文、英语、西班牙语、印度尼西亚语、马来语、泰语、阿拉伯语、葡萄牙语、越南语、日语、韩语。

接口地址#

提交任务#

POST {BASE_URL}/v1/video/generations

查询结果#

GET {BASE_URL}/v1/video/generations/{task_id}

请求参数#

顶级参数#

参数类型必填说明
modelstring是模型名称:doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615 或 doubao-seedance-2-5-260628
promptstring是文本提示词(平台校验要求非空,实际提示词通过 metadata.content 传递)
metadataobject是扩展参数对象,包含所有 Seedance 2.0 / 2.5 参数

metadata 参数#

参数类型必填说明默认值
contentobject[]是输入给模型的内容数组,详见下方 content 参数说明-
generate_audioboolean否控制生成的视频是否包含与画面同步的声音true
resolutionstring否视频分辨率,取值随模型而不同,详见下方 resolution 参数说明"720p"
ratiostring否视频宽高比"adaptive"
durationinteger否视频时长(秒)5
toolsobject[]否配置模型要调用的工具-
output_formatstring否输出视频格式,mp4 或 mov,仅 doubao-seedance-2-5-260628 支持,详见下方 output_format 参数说明"mp4"
omni_reference_task_typestring否全模态参考生视频任务类型引导,auto / reference / edit / extend,仅 doubao-seedance-2-5-260628 支持,详见下方 omni_reference_task_type 参数说明"auto"
注意:prompt 字段必须非空(平台校验要求),但实际发送给上游的提示词来自 metadata.content 中的文本内容。如果未传 metadata.content,平台会自动将 prompt 转换为 content 数组。

content 参数详细说明#

metadata.content 为对象数组,输入给模型生成视频的信息,支持文本、图片、音频、视频。支持以下几种组合:
文本
文本(可选)+ 图片
文本(可选)+ 视频
文本(可选)+ 图片 + 音频
文本(可选)+ 图片 + 视频
文本(可选)+ 视频 + 音频
文本(可选)+ 图片 + 视频 + 音频

文本信息#

输入给模型的提示词信息。
字段类型必填说明
typestring是固定为 "text"
textstring是文本提示词,描述期望生成的视频。支持中英文。建议中文不超过 500 字,英文不超过 1000 词。字数过多信息容易分散,模型可能忽略细节,造成视频缺失部分元素。
示例:
{
  "type": "text",
  "text": "清晨的海边,金色阳光照耀在海面上,一只海豚跃出水面,水花四溅"
}

图片信息#

输入给模型的图片信息。
字段类型必填说明
typestring是固定为 "image_url"
image_urlobject是图片对象
image_url.urlstring是图片 URL、Base64 编码或素材 ID(见下方说明)
rolestring条件必填图片的位置或用途(见下方说明)
image_url.url 支持的格式:
图片 URL:填入图片的公网 URL
Base64 编码:格式 data:image/<图片格式>;base64,<Base64编码>,如 data:image/png;base64,{base64_image}
素材 ID:格式 asset://<ASSET_ID>
传入单张图片要求:
格式:jpeg、png、webp、bmp、tiff、gif
宽高比(宽/高):(0.4, 2.5)
宽高长度(px):(300, 6000)
大小:单张图片小于 30 MB,请求体大小不超过 64 MB。大文件请勿使用 Base64 编码
图片数量:
图生视频-首帧:1 张
图生视频-首尾帧:2 张
多模态参考生视频:Seedance 2.0 系列(标准版 / fast / mini)1~9 张;Seedance 2.5 最多 30 张
role 取值说明:
图生视频-首帧、图生视频-首尾帧、多模态参考生视频为 3 种互斥场景,不可混用。
场景图片数量role 取值说明
图生视频-首帧1 张first_frame 或不填以该图片作为视频首帧
图生视频-首尾帧2 张首帧:first_frame(必填),尾帧:last_frame(必填)指定视频的首帧和尾帧图片
多模态参考生视频2.0 系列(标准版 / fast / mini)1~9 张;2.5 最多 30 张reference_image(必填)作为参考图片生成视频
示例(首帧图生视频):
{
  "type": "image_url",
  "image_url": { "url": "https://example.com/image.jpg" },
  "role": "first_frame"
}
示例(参考图):
{
  "type": "image_url",
  "image_url": { "url": "https://example.com/ref.jpg" },
  "role": "reference_image"
}

视频信息#

输入给模型的视频信息。Seedance 2.0 系列(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615)与 Seedance 2.5(doubao-seedance-2-5-260628)均支持。
支持使用本账号下上述模型产出的视频作为输入素材,进行视频编辑或延长,其中的真人人脸可正常使用,不会触发审核拦截。
字段类型必填说明
typestring是固定为 "video_url"
video_urlobject是视频对象
video_url.urlstring是视频 URL 或素材 ID(格式 asset://<ASSET_ID>)
rolestring条件必填当前仅支持 "reference_video"
传入视频要求:
格式:mp4、mov
分辨率:480p、720p
时长:单个视频 [2, 15] 秒,Seedance 2.0 系列(标准版 / fast / mini)最多传入 3 个参考视频(总时长不超过 15s),Seedance 2.5 最多传入 10 个参考视频
宽高比(宽/高):[0.4, 2.5]
宽高长度(px):[300, 6000]
画面像素(宽 × 高):[409600, 927408]
示例:640×640=409600(最小值),834×1112=927408(最大值)
大小:单个视频不超过 50 MB
帧率 (FPS):[24, 60]
示例:
{
  "type": "video_url",
  "video_url": { "url": "https://example.com/video.mp4" },
  "role": "reference_video"
}

音频信息#

输入给模型的音频信息。Seedance 2.0 系列(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128、doubao-seedance-2-0-mini-260615)与 Seedance 2.5(doubao-seedance-2-5-260628)均支持。
Seedance 2.0 系列不可单独输入音频,应至少包含 1 个参考视频或图片;Seedance 2.5(doubao-seedance-2-5-260628)新增支持纯音频参考生成视频,无需搭配图片或视频素材。
字段类型必填说明
typestring是固定为 "audio_url"
audio_urlobject是音频对象
audio_url.urlstring是音频 URL、Base64 编码或素材 ID
rolestring条件必填当前仅支持 "reference_audio"
audio_url.url 支持的格式:
音频 URL:填入音频的公网 URL
Base64 编码:格式 data:audio/<音频格式>;base64,<Base64编码>,如 data:audio/wav;base64,{base64_audio}
素材 ID:格式 asset://<ASSET_ID>
传入音频要求:
格式:wav、mp3
时长:单个音频 [2, 15] 秒,Seedance 2.0 系列(标准版 / fast / mini)最多传入 3 段参考音频(总时长不超过 15s),Seedance 2.5 最多传入 10 段参考音频
大小:单个音频不超过 15 MB,请求体大小不超过 64 MB。大文件请勿使用 Base64 编码
示例:
{
  "type": "audio_url",
  "audio_url": { "url": "https://example.com/audio.wav" },
  "role": "reference_audio"
}

其他参数详细说明#

generate_audio#

取值说明
true(默认)模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:"你记住,以后不可以用手指指月亮。"
false模型输出的视频为无声视频
生成的有声视频均为单声道,和传入的音频声道数无关。

resolution#

视频分辨率,默认值 "720p"。不同模型支持的分辨率不同:
模型支持的分辨率
doubao-seedance-2-0-260128480p、720p、1080p、4k
doubao-seedance-2-0-fast-260128480p、720p
doubao-seedance-2-0-mini-260615480p、720p
doubao-seedance-2-5-260628480p、720p
取值说明
"480p"低分辨率,生成速度较快,成本最低
"720p"高分辨率,画质更好(默认值)
"1080p"全高清,画质更细腻,仅 doubao-seedance-2-0-260128 支持
"4k"超高清,最高画质,仅 doubao-seedance-2-0-260128 支持
注意:向不支持高分辨率的模型(fast / mini / 2.5)传入 1080p 或 4k 会导致请求被拒绝或自动降级,请根据所选模型传入合法取值。分辨率越高,生成耗时越长、计费越高。

ratio#

视频宽高比,默认值 "adaptive"。
取值说明
"16:9"横屏宽幅
"4:3"横屏标准
"1:1"正方形
"3:4"竖屏标准
"9:16"竖屏全屏
"21:9"超宽屏 / 电影比例
"adaptive"根据输入自动选择最合适的宽高比
adaptive 适配规则:
文生视频:根据提示词智能选择最合适的宽高比
首帧/首尾帧生视频:根据上传的首帧图片比例,自动选择最接近的宽高比
多模态参考生视频:根据用户提示词意图判断,以传入的第一个媒体文件为准(优先级:视频 > 图片)选择最接近的宽高比
不同宽高比对应的宽高像素值:
分辨率宽高比宽高像素值
480p16:9864×496
480p4:3752×560
480p1:1640×640
480p3:4560×752
480p9:16496×864
480p21:9992×432
720p16:91280×720
720p4:31112×834
720p1:1960×960
720p3:4834×1112
720p9:16720×1280
720p21:91470×630
上表为 480p / 720p 的宽高像素对照,所有模型均支持。1080p 与 4k 仅 doubao-seedance-2-0-260128 支持,其像素值按对应宽高比等比放大(如 1080p 16:9 约 1920×1080,4k 16:9 约 3840×2160)。

duration#

视频时长(秒),默认值 5,仅支持整数。时长上限随模型而不同:
模型时长范围
doubao-seedance-2-0-2601284~15 秒
doubao-seedance-2-0-fast-2601284~15 秒
doubao-seedance-2-0-mini-2606154~15 秒
doubao-seedance-2-5-2606284~30 秒
取值说明
指定时长指定具体时长,支持有效范围内的任一整数。Seedance 2.0 系列(标准版 / fast / mini)为 4~15 秒;Seedance 2.5(doubao-seedance-2-5-260628)上限延长至 30 秒
-1智能指定,由模型在有效范围内自主选择合适的视频长度。实际时长可通过查询 API 返回的 duration 字段获取。注意视频时长与计费相关,请谨慎设置

tools#

配置模型要调用的工具。仅 Seedance 2.0 标准版与快速版(doubao-seedance-2-0-260128、doubao-seedance-2-0-fast-260128)支持;doubao-seedance-2-0-mini-260615 与 doubao-seedance-2-5-260628 暂不支持。
字段类型说明
typestring工具类型,当前支持 "web_search"(联网搜索,仅文生视频支持)
开启联网搜索后,模型会根据提示词自主判断是否搜索互联网内容(如商品、天气等)。可提升生成视频的时效性,但也会增加一定的时延。
实际搜索次数可通过查询视频生成任务接口返回的 usage.tool_usage.web_search 字段获取,为 0 表示未搜索。
示例(放在 metadata 内):
{
  "model": "doubao-seedance-2-0-260128",
  "prompt": "占位",
  "metadata": {
    "content": [{ "type": "text", "text": "今天北京的天气播报" }],
    "tools": [{ "type": "web_search" }]
  }
}

output_format#

输出视频格式,默认值 "mp4"。仅 doubao-seedance-2-5-260628 支持,2.0 系列(标准版 / fast / mini)不支持该参数。
取值编码与色彩适用场景
"mp4"(默认)H.264、AAC、yuv420p兼容性较好,适合播放、交付和分发
"mov"H.264、PCM、yuv444p色彩精度较高,适合延长、拼接、调色、抠像和合成
mov 文件通常体积更大;视频延长场景建议输入和输出均使用 mov,以提升声画衔接与色彩一致性。
示例(放在 metadata 内):
{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "占位",
  "metadata": {
    "content": [{ "type": "text", "text": "清晨的海边,一只海豚跃出水面" }],
    "duration": 5,
    "output_format": "mov"
  }
}

omni_reference_task_type#

全模态参考生视频任务类型引导,默认值 "auto"。仅 doubao-seedance-2-5-260628 支持。
Seedance 2.5 全模态参考生视频任务包括参考生视频、视频编辑和视频延长 3 类子任务。不同任务类型对参数有特殊限制,为减少任务创建后异步报错的情况,可通过本参数指定子任务类型,以提前校验对应限制。
默认情况下(omni_reference_task_type=auto):模型根据输入素材和提示词自动判定任务类型,再校验参数取值。如果参数与实际任务类型不兼容,任务将触发异步报错。
显式指定任务类型(reference / edit / extend):接口在提交任务时提前校验对应任务的特殊参数限制,不符合要求时立即报错,任务不会创建。
注意:实际处理任务时,模型仍会进一步结合提示词判断任务类型。若实际判定的任务类型与指定的不一致,仍会触发异步报错。建议遵循各任务类型的提示词写法,降低报错概率。
取值说明
"auto"(默认)由模型根据输入素材和提示词自动判定任务类型
"reference"参考生视频任务,即基于参考图片、参考视频或参考音频生成新视频。设 reference 时,ratio 或 duration 无特殊限制
"edit"视频编辑任务,即对原视频的画面或音频进行编辑操作。设 edit 时,content 中必须至少包含一个 reference_video,且视频时长必须为 4~30 秒;ratio 必须为 adaptive;duration 必须为 -1
"extend"视频延长任务,即对原视频向前或向后延长。设 extend 时,content 中必须至少包含一个 reference_video;ratio 必须为 adaptive
示例(放在 metadata 内):
{
  "model": "doubao-seedance-2-5-260628",
  "prompt": "占位",
  "metadata": {
    "content": [
      { "type": "text", "text": "延长这段视频" },
      { "type": "video_url", "video_url": { "url": "https://example.com/video.mp4" }, "role": "reference_video" }
    ],
    "ratio": "adaptive",
    "duration": -1,
    "omni_reference_task_type": "extend"
  }
}

Seedance 2.5(doubao-seedance-2-5-260628)专属参数说明#

doubao-seedance-2-5-260628 与 2.0 系列共用同一套请求结构,但在素材数量、参考图、时长、宽高比、音频、语言等参数上有独立行为,使用前请重点关注以下差异。

1. 参考图与素材数量#

素材类型Seedance 2.0 系列(标准版 / fast / mini)Seedance 2.5(doubao-seedance-2-5-260628)
参考图片(reference_image)多模态参考生视频 1~9 张多模态参考生视频最多 30 张
参考视频(reference_video)最多 3 个,总时长 ≤ 15s最多 10 个
参考音频(reference_audio)最多 3 段,总时长 ≤ 15s,且不可单独输入最多 10 段,且支持纯音频参考生成视频
单次素材总量-最多 50 个(30 图 + 10 视频 + 10 音频)
首帧(first_frame)、首尾帧(first_frame + last_frame)、多模态参考(reference_image)三种场景互斥,不可混用,此规则对所有模型一致。

2. 时长(duration)#

Seedance 2.5 时长范围为 430 秒(2.0 系列为 415 秒),可一次性生成长达 30 秒的连贯视频,无需多段拼接。
支持传入 -1 让模型智能决定时长;但在视频编辑、视频延长任务中,duration 默认且仅支持 -1,输出时长与输入视频基本保持一致,不支持另行指定(见下方智能控制行为)。

3. 宽高比(ratio)#

常规文生视频 / 图生视频场景中,ratio 取值与 2.0 系列一致,支持 16:9、4:3、1:1、3:4、9:16、21:9、adaptive。
在视频编辑、视频延长任务中,ratio 默认且仅支持 adaptive,输出宽高比自动与输入视频保持一致,不支持另行指定(见下方智能控制行为)。

4. 分辨率(resolution)#

Seedance 2.5 仅支持 480p 与 720p,不支持 1080p 与 4k(仅 doubao-seedance-2-0-260128 支持高分辨率)。

5. 纯音频参考生成视频#

Seedance 2.5 新增支持仅凭音频素材(reference_audio)生成视频,无需搭配任何图片或视频;2.0 系列则必须至少包含 1 个参考视频或图片。

6. 原生多语言生成#

Seedance 2.5 原生支持多种语言的提示词输入和有声视频生成,覆盖:中文、英语、西班牙语、印度尼西亚语、马来语、泰语、阿拉伯语、葡萄牙语、越南语、日语、韩语。

Seedance 2.5 智能控制行为#

doubao-seedance-2-5-260628 支持通过配置 ratio 为 adaptive、duration 为 -1 以智能控制输出视频的宽高比和时长;但在视频编辑、视频延长、首帧或首尾帧生视频任务中,具有特殊的控制行为,详情参考以下示例。

使用示例 - 视频编辑#

仅 doubao-seedance-2-5-260628 支持视频编辑 / 视频延长。在视频编辑任务中,输出视频宽高比将自动和输入视频的宽高比保持一致(参数 ratio 默认且仅支持配置为 adaptive),输出视频时长自动和输入视频时长基本保持一致(参数 duration 默认且仅支持配置为 -1)。上述两项均不支持另行设置。
任务类型ratioduration
视频编辑默认且仅支持 adaptive,与输入视频宽高比一致默认且仅支持 -1,与输入视频时长基本一致

使用示例 - 首帧 / 首尾帧生视频#

仅 doubao-seedance-2-5-260628 在首帧或首尾帧生视频任务中支持以下智能控制;2.0 系列无此行为,需显式指定 ratio 与 duration。
任务类型ratioduration
首帧生视频支持配置,建议 adaptive支持 -1 智能决定
首尾帧生视频(视频延长)默认且仅支持 adaptive,与输入视频宽高比一致默认且仅支持 -1,与输入视频时长基本一致

原生多语言生成#

Seedance 2.5 原生支持多种语言的提示词输入和有声视频生成,覆盖支持:中文、英语、西班牙语、印度尼西亚语、马来语、泰语、阿拉伯语、葡萄牙语、越南语、日语、韩语。

重要提示:关于提示词传递#

在 Windows 命令行(cmd / PowerShell)中使用 curl 直接传递中文提示词可能出现编码问题,导致生成内容与提示词不符。
推荐做法:先将请求 JSON 写入 UTF-8 编码的文件,再使用 --data-binary @文件名 发送请求。
通过 Python、Java、前端应用等编程语言调用 API 不受此影响,因为这些语言默认使用 UTF-8 编码。

错误示例(Windows 下中文可能乱码)#

正确示例(使用文件方式)#


请求示例#

cURL(推荐文件方式)#

文生视频#

图生视频(首帧)#

多模态参考生视频(图片+音频+文本)#

Python#

Java#


查询结果#

查询请求#

查询响应示例#

生成中#

{
  "code": "success",
  "data": {
    "task_id": "cgt-20260326182734-68xp4",
    "status": "IN_PROGRESS",
    "progress": "30%",
    "data": {
      "model": "doubao-seedance-2-0-260128",
      "status": "running",
      "generate_audio": true
    }
  }
}

生成成功#

{
  "code": "success",
  "data": {
    "task_id": "cgt-20260326182734-68xp4",
    "status": "SUCCESS",
    "progress": "100%",
    "data": {
      "model": "doubao-seedance-2-0-260128",
      "ratio": "9:16",
      "duration": 8,
      "resolution": "480p",
      "generate_audio": true,
      "framespersecond": 24,
      "content": {
        "video_url": "https://...mp4?..."
      },
      "usage": {
        "total_tokens": 80770,
        "completion_tokens": 80770
      }
    }
  }
}

生成失败#

{
  "code": "success",
  "data": {
    "task_id": "cgt-xxxxx",
    "status": "FAILURE",
    "fail_reason": "task failed",
    "data": {
      "error": {
        "code": "OutputVideoSensitiveContentDetected",
        "message": "The request failed because the output video may contain sensitive information."
      }
    }
  }
}

任务状态说明#

状态说明
NOT_START任务已提交,尚未开始
IN_PROGRESS任务正在生成中
SUCCESS生成成功,可获取视频 URL
FAILURE生成失败,查看 fail_reason
修改于 2026-08-17 09:05:26
上一页
素材库自定义阿里云OSS教程
下一页
豆包 Seedance 2.5 草稿样片与正片 API 接口文档
Built with