请输入
菜单

Seedance视频生成

通过 AiLink 调用豆包 Seedance 视频生成接口,可完成文生视频、首帧图生视频和参考视频生视频。任务以异步方式执行:创建任务后,使用返回的任务 ID 查询状态并下载结果。

调用准备:

•网关地址:https://ailink.nativex.com
•认证方式:请求头携带 Authorization: Bearer sk-xxxx,将 sk-xxxx 替换为你的 API Key
•数据格式:application/json

1. 创建视频生成任务

请求

•方法:POST
•路径:/doubao/api/v3/contents/generations/tasks

Body 参数:

参数 类型 必填 说明与取值
model string 是 网关中的模型名称,见下方模型规格表
content object[] 是 输入内容数组,包含文本及所需素材;对象结构见下表
resolution string 否 输出分辨率;按模型选择 480p、720p、1080p 或 4k,方舟默认 720p;建议显式传入
ratio string 否 16:9、4:3、1:1、3:4、9:16、21:9、adaptive;默认 adaptive,由模型适配宽高比
duration integer 否 输出秒数:2.5 为 4~30,2.0 系列为 4~15;方舟还支持 -1 自动选择,2.5 默认 -1。本文示例显式使用 5 秒
generate_audio boolean 否 true 生成有声视频,false 生成无声视频;默认 true
watermark boolean 否 true 添加水印,false 不添加水印;默认 false
return_last_frame boolean 否 默认 false;设为 true 后,可在查询结果中取得生成视频的尾帧图像
output_format string 否 仅 2.5:mp4 或 mov,默认 mp4
omni_reference_task_type string 否 仅 2.5 全模态参考任务:auto(默认)、reference(参考生成)、edit(编辑)、extend(延长);须满足对应任务限制

模型规格:

模型 输出分辨率 指定输出时长
doubao-seedance-2-5-260628 480p / 720p / 1080p 4~30 秒
doubao-seedance-2-0-260128 480p / 720p / 1080p / 4k 4~15 秒
doubao-seedance-2-0-fast-260128 480p / 720p 4~15 秒
doubao-seedance-2-0-mini-260615 480p / 720p 4~15 秒

content 对象字段:

字段 类型 说明与取值
type string 文本用 text,图片用 image_url,视频用 video_url,参考音频用 audio_url
text string type=text 时必填,描述希望生成的内容
image_url.url string type=image_url 时必填;本文示例使用公网图片 URL
video_url.url string type=video_url 时必填;使用公网视频 URL,视频不支持 Base64
audio_url.url string type=audio_url 时必填;可使用公网音频 URL
role string 图片:first_frame(首帧)、last_frame(尾帧)或 reference_image(参考图);视频固定为 reference_video;音频固定为 reference_audio
参数取值及模型限制依据方舟创建视频生成任务文档。其中默认值指方舟模型默认值。首帧、首尾帧和全模态参考是互斥的输入方式,不要将 first_frame / last_frame 与参考图、参考视频或参考音频混用。2.0 系列的参考音频须搭配参考图片或视频,2.5 可单独使用参考音频。

响应

成功响应示例:

{"id": "task_xxxxxxxx"}
字段 类型 说明
id string 本次生成任务的 ID,后续查询使用此值

示例

以下请求生成一段 480p、5 秒的无声视频:

curl -X POST 'https://ailink.nativex.com/doubao/api/v3/contents/generations/tasks' \
  -H 'Authorization: Bearer sk-xxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "doubao-seedance-2-0-mini-260615",
    "content": [
      {"type": "text", "text": "一只橘猫在草地上慢慢走"}
    ],
    "resolution": "480p",
    "ratio": "16:9",
    "duration": 5,
    "generate_audio": false,
    "watermark": false
  }'

2. 查询视频生成结果

请求

•方法:GET
•路径:/doubao/api/v3/contents/generations/tasks/{task_id}
路径参数 类型 必填 说明
task_id string 是 创建任务返回的 id

无请求体。生成通常需要几分钟,建议每 10 秒左右查询一次,直到任务进入结束状态。

响应

以下为成功结果的简化结构示例,视频 URL 和用量仅用于说明字段:

{
  "id": "task_xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "total_tokens": 100000
  }
}

字段说明:

字段 类型 说明
id string 任务 ID
status string 任务当前状态,见下表
content.video_url string 成功后返回的视频下载地址
content.last_frame_url string 请求 return_last_frame=true 时返回的尾帧图像地址
usage.total_tokens integer 本次任务的实际 token 用量,以返回结果为准
error object 失败时返回的错误信息

任务状态:

状态 说明 后续操作
queued 排队中 等待后继续查询
running 生成中 等待后继续查询
succeeded 已成功 下载视频,停止轮询
failed 已失败 查看错误信息,停止轮询
cancelled 已取消 停止轮询
expired 已超时 停止轮询

示例

将 task_xxxxxxxx 替换为实际任务 ID:

curl 'https://ailink.nativex.com/doubao/api/v3/contents/generations/tasks/task_xxxxxxxx' \
  -H 'Authorization: Bearer sk-xxxx'

3.在控制台查看进度与生成的视频

视频生成类请求是异步任务。提交任务后,可进入网关控制台 → 任务日志,查看任务生成进度。生成成功后,点击对应任务的「制品」,即可正常查看和下载生成的视频。

小提示:生成的视频地址仅保留 24 小时,超时后无法访问,请在生成后及时下载保存。

4.首帧图生视频

创建任务的接口和查询方式不变。保留文本提示词,将 content 替换为以下数组,并把图片 URL 替换为你的素材地址:

[
  {"type": "text", "text": "让画面中的主体缓慢向前移动"},
  {
    "type": "image_url",
    "image_url": {"url": "https://example.com/first.png"},
    "role": "first_frame"
  }
]

如需指定尾帧,可再加入一张 role=last_frame 的图片,与首帧配对使用。

使用 Seedance 2.5 进行首帧或首尾帧生成时,ratio 仅支持 adaptive。请将文生视频示例中的 16:9 改为 adaptive,模型将保持首帧图片的宽高比。

5. 参考视频生视频

创建任务的接口和查询方式不变。将 content 替换为以下数组,并把视频 URL 替换为你的素材地址:

[
  {"type": "text", "text": "参考视频中的运动方式,生成一只橘猫在草地上慢慢走的视频"},
  {
    "type": "video_url",
    "video_url": {"url": "https://example.com/ref.mp4"},
    "role": "reference_video"
  }
]

Seedance 2.5 可用 omni_reference_task_type=reference 引导参考生成;提示词应表达“参考素材生成新内容”的意图。

2.5 的视频编辑须使用 ratio=adaptive、duration=-1,并提供 4~30 秒的参考视频;视频延长须使用 ratio=adaptive。即使任务提交成功,实际意图与参数不符仍可能异步失败,请持续查询状态。

素材要求

素材 规格
图片 单张小于 30 MB;宽、高各为 300~6000 像素,宽高比 0.4~2.5;首帧 1 张,首尾帧 2 张
参考视频 mp4 或 mov;单个不超过 200 MB;24~60 FPS;宽、高各为 300~6000 像素,宽高比 0.4~2.5,总像素数为 407696~8295044
2.5 参考视频时长 通常单个 2~30 秒;编辑任务为 4~30 秒;最多 10 个,总时长不超过 30 秒
2.0 系列参考视频时长 单个 2~15 秒;最多 3 个,总时长不超过 15 秒

本文示例统一使用公网可访问的素材 URL。方舟也支持图片 Base64;参考视频不支持 Base64。请注意,输入素材时长与 duration 指定的输出时长是两个不同参数。

其他高级参数及最新模型限制,请参阅方舟官方接口文档。

最近修改: 2026-10-28