通过 AiLink 调用豆包 Seedance 视频生成接口,可完成文生视频、首帧图生视频和参考视频生视频。任务以异步方式执行:创建任务后,使用返回的任务 ID 查询状态并下载结果。
调用准备:
•网关地址:
https://ailink.nativex.com•认证方式:请求头携带
Authorization: Bearer sk-xxxx,将 sk-xxxx 替换为你的 API Key•数据格式:
application/json1. 创建视频生成任务
请求
•方法:
POST•路径:
/doubao/api/v3/contents/generations/tasksBody 参数:
| 参数 | 类型 | 必填 | 说明与取值 |
|---|---|---|---|
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 指定的输出时长是两个不同参数。
其他高级参数及最新模型限制,请参阅方舟官方接口文档。