Seedance 系列

Seedance 支持文生视频、首帧、首尾帧过渡、参考图/视频/音频驱动，以及可选的自动音频。官方模型名的 /api/v3 创建、查询、列表及自动时长、草稿功能，见Seedance 方舟原生接口；本页描述 /v1 路径。

快速开始

curl https://api.vibelab.me/v1/videos/generations \
  -H "Authorization: Bearer $LOOPTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "ratio": "16:9",
    "content": [{"type": "text", "text": "海边日落，海浪拍打礁石，镜头缓慢横移，电影级光影"}],
    "duration": 5
  }'

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "pending",
  "progress": 0,
  "created_at": 1783819200,
  "duration": 5,
  "resolution": "720p"
}

轮询：GET /v1/tasks/{task_id}。pending/running 继续轮询；succeeded 读 video_url；failed 读 error。

模式选择

请求参数

请求头：Authorization: Bearer <your-api-key>（必填），Content-Type: application/json（必填）。

content 对象

role 数量限制：

素材上限：

• 2.5 单次图片、视频、音频合计最多 50 个素材。各通道例外见适用模型。
• 传参考音频时，generate_audio 决定是否同时生成额外配音或音效。
• 多素材参考时每张图都标 reference_image，不要与 first_frame/last_frame 混在一次请求：上游按 role 判断是“多图参考”还是“首尾帧过渡”，混传按后者处理。
• 提示词里用 @图1、@视频1（分销版 @图片1）指代素材，编号按各自类型在 content 中的出现顺序从 1 起。

适用模型

seedance-2-5 与 seedance-2-0 是两代标准款，参数范围最窄，不确定选哪个先用它们试跑通。同代下按后缀区分通道：-max、-hig 长片版，-duo 分销版，seedance-2.5-c、seedance-2.5-c1、seedance-2.5-c2、seedance-2.5-c7、seedance-2.0-c 按次版。请求体形状一致，差别只在参数范围、计费方式和出片速度。

ratio 取值缩写：R7 = adaptive、21:9、16:9、4:3、1:1、3:4、9:16；R6 = R7 去掉 adaptive；无 = 不支持，— = 原文未单列。素材上限写作 图/视频/音频。

按秒计费 · Seedance 2.5

按秒计费 · Seedance 2.0

按次计费（每条一个价，见按次版）

实际可用模型与价格以模型列表为准。越界参数统一返回 400（任务不建立、不计费），下文不再逐条重复。

标准版

seedance-2-5、seedance-2-0：

• ratio 取值同 R7（含 adaptive），不传按 16:9 出片。
• 图片只能用 role: reference_image，带 first_frame/last_frame 返回 400。
• 提示词不能为空，只传参考图返回 400。
• 以下顶层字段带了返回 400（message 为 <字段> is not supported for <模型>）：seed、camera_fixed、return_last_frame、draft、service_tier、execution_expires_after、omni_reference_task_type。generate_audio 不报错，但会被忽略。
• seedance-2-0 写 20 秒返回 400（上限 15 秒），要更长用 seedance-2-5。duration 不传按 5 秒出片。
• seedance-2-5 不再有 1080p，要 1080p 用 seedance-2-5-max。
• 带参考视频按加价档计费，每秒比同分辨率纯文生贵一档。

2.5 特殊约束（doubao-seedance-2-5-cloud 等 2.5 模型）

• 首帧、首尾帧、视频编辑、视频延长必须 ratio: "adaptive"。
• 编辑：omni_reference_task_type: "edit"、duration: -1，至少一个 4-30 秒参考视频。
• 延长：omni_reference_task_type: "extend"，至少一个参考视频。
• 2.5 不支持 4k。

长片版（-max、-hig）

长片版共同点：按秒计费、不支持首帧/尾帧（带 first_frame/last_frame 返回 400）、回报真实 progress、不传 ratio 一律按 16:9 出片（要自适应显式写 adaptive）、role: reference_video 都收。

• -max 的比例范围为 R6（横竖屏之外还有 1:1、4:3、3:4、21:9），不要求带参考图。
• duration：2.5 是 4-30，2.0 是 4-15。按 2.5 写法给 2.0 的 -hig 发 20 秒返回 400。
• 素材上限按代走：2.5 的 -hig 最多 10 个视频、30 张图；2.0 的 -hig 最多 3 个视频、9 张图。超限返回 400。

长片版的参考视频

视频只当风格与氛围参考：画面内容由提示词决定，源视频既不被照搬也不被逐帧改写。要按源视频逐帧编辑，用 doubao-seedance-2-5-cloud 的编辑任务。

单个视频须满足下表，否则提交后才失败，任务以 upstream_error 收尾、预扣全额退回：

素材 URL 必须是可匿名直接下载的直链：上游拉素材不带 User-Agent、不跟随跳转。对 UA 有要求的图床（维基共享资源）返回 403，带 302 的随机图链接（picsum.photos 之类）拉不到，两者都在提交之后才失败，任务以 upstream_error 收尾、预扣全额退回。用自己的 OSS 或对象存储直链最稳。

通道改投

同代长片通道不带参考视频时价格一致，换 model 后缀即可换产能：

分销版（-duo）

四个模型：seedance-2-5-duo、seedance-2-0-duo，以及 2.0 轻量款 seedance-2-0-fast-duo（速度款）、seedance-2-0-mini-duo（最便宜）。时长范围与长片版一样宽，但支持首帧和尾帧（长片版都不支持）；要长片又要首尾帧过渡，只能选这四个。

• 其余同适用模型：duration、R7、素材上限、首尾帧。
• 参考图可带可不带，只给提示词即文生视频。素材一律传公网 HTTPS 地址，不接受 Base64。
• seedance-2-5-duo 上游偶尔把多图参考判成首尾帧时，用 omni_reference_task_type: "reference" 显式钉死。

按次版（-c）

seedance-2.5-c、seedance-2.5-c1、seedance-2.5-c2、seedance-2.5-c7、seedance-2.0-c：请求体与其他 Seedance 模型一致，照常传 duration、参考素材，但按次计费：同分辨率每条一个价，4 秒和 30 秒（2.0 为 15 秒）同价，带参考视频也不加价（seedance-2.5-c2 例外：与分辨率无关，按时长分 ≤15 秒、>15 秒两档价；seedance-2.5-c7 例外：带参考视频走单独的加价档）。适合长片；短片按秒模型更便宜。

• 不支持 duration: -1、generate_audio: false、return_last_frame、draft、编辑/延长，传了返回 400。
• first_frame/last_frame 图会收下，但按参考图交给上游，不保证严格作为首尾帧。
• ratio: adaptive 或不传时按 16:9 出片。
• 素材一律传公网 HTTPS 地址，不接受 Base64。
• seedance-2.5-c7 只出 720p（传 480p/1080p 返回 400），其余边界同 2.5（含 21:9，素材最多 30 图 10 视频 10 音频）。
• seedance-2.5-c1 只出 720p，不支持 21:9（adaptive 按 16:9），提示词最多 10000 字，素材最多 9 图 3 视频 3 音频；带参考视频或参考音频时至少要有 1 张参考图，否则返回 400。

ratio 与 adaptive

ratio: adaptive 时，文生视频按提示词选比例，首帧/首尾帧按首帧选最接近的比例。

请求示例

首帧：

{
  "model": "doubao-seedance-2-0-260128",
  "ratio": "16:9",
  "content": [
    {"type": "text", "text": "小猫缓缓睁开眼睛，站起来伸懒腰，镜头轻微向前推进"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/cat-first-frame.jpg"}}
  ],
  "duration": 4
}

首尾帧：

{
  "model": "seedance-2-5-duo",
  "content": [
    {"type": "text", "text": "人物从房间走到花园，镜头平稳跟随，自然光"},
    {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://cdn.example.com/first.png"}},
    {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://cdn.example.com/last.png"}}
  ],
  "resolution": "1080p",
  "ratio": "adaptive",
  "duration": 8,
  "generate_audio": true
}

多素材参考（图 + 视频）：

{
  "model": "seedance-2-0-duo",
  "content": [
    {"type": "text", "text": "参考 @图片1 的角色和 @视频1 的运镜，生成一段产品广告片"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://cdn.example.com/role.png"}},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://cdn.example.com/move.mp4"}}
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 10
}

参考图生视频（长片版）：

{
  "model": "seedance-2-5-hig",
  "content": [
    {"type": "text", "text": "镜头缓慢环绕产品一周，干净背景，真实光影，高级质感"},
    {"type": "image_url", "role": "reference_image", "image_url": {"url": "https://example.com/product.png"}}
  ],
  "resolution": "720p",
  "ratio": "adaptive",
  "duration": 20,
  "generate_audio": true
}

参考视频（长片版，视频只作风格参考）：

{
  "model": "seedance-2-0-hig",
  "content": [
    {"type": "text", "text": "一只白猫蹲在木桌上吃东西，室内自然光"},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/reference.mp4"}}
  ],
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 10,
  "generate_audio": true
}

2.5 视频编辑（doubao-seedance-2-5-cloud）：

{
  "model": "doubao-seedance-2-5-cloud",
  "content": [
    {"type": "text", "text": "将 @Video 1 的天空替换为晚霞，保留人物动作和原始对白"},
    {"type": "video_url", "role": "reference_video", "video_url": {"url": "https://example.com/source.mov"}}
  ],
  "omni_reference_task_type": "edit",
  "ratio": "adaptive",
  "duration": -1,
  "output_format": "mov"
}

响应

提交响应

HTTP 202：

查询任务

GET /v1/tasks/{task_id}，路径参数 task_id 为提交返回的 vt_... ID。

progress 为 0-100，终态一律 100。只有长片版（-max、-hig）回报真实进度，其余模型生成期间恒为 0——判断是否结束请看 status。

成功响应字段：

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1783819200,
  "completed_at": 1783819268,
  "video_url": "https://example.com/generated/video.mp4",
  "expires_at": 1784078468,
  "duration": 4,
  "resolution": "720p",
  "ratio": "16:9",
  "usage": {"duration": 4, "video_count": 1, "SR": 720, "ratio": "16:9", "output_video_duration": 4},
  "credits_charged": 24
}

失败响应字段：status=failed；error.code 为 timeout 或 upstream_error；error.message 失败原因；completed_at 失败时间。

{
  "task_id": "vt_019c8d85-75fd-7a31-b33f-8cf90e83a62b",
  "model": "doubao-seedance-2-0-260128",
  "status": "failed",
  "progress": 100,
  "error": {"code": "upstream_error", "message": "video generation failed"},
  "completed_at": 1783819268
}

计费

按秒模型按“实际时长 × 分辨率档位单价”，按次模型（seedance-2.5-c、seedance-2.5-c1、seedance-2.5-c2、seedance-2.5-c7、seedance-2.0-c）按“条数 × 分辨率档位单价”，实时价格见模型列表。

参考视频加价口径各通道不同，改投通道时要重算预算：

• -duo 720p 单价（积分每秒）：-mini-duo 0.817、-fast-duo 1.228、seedance-2-0-duo 1.62、seedance-2-5-duo 2.774。
• seedance-2-0-duo 的 4k 单价是 720p 的近 9 倍（14.45 对 1.62 积分每秒），上游对 4k 用另一套倍率，不要线性估预算。
• 失败：upstream_error 预扣全额退回；timeout 退款。

错误

通用错误见接口说明，本页补充：

常见 message（<model> 为请求的模型）：

统一错误体格式见错误码。

注意事项

• 公网 URL 必须允许模型服务直接下载，不能要求登录、Cookie 或临时请求头 → 用自己的对象存储直链。
• Base64 只适用于图片，格式 data:image/png;base64,... 或 data:image/jpeg;base64,...；视频、音频传公网 URL。
• 首尾帧的主体、构图、宽高比应尽量接近 → 否则易跳变、形变或过渡失败。
• 生成结果 URL 有时效 → 成功后立即下载到自己的存储。
• 长片版等慢通道长时间停在 running/低 progress 属正常 → 不要重复提交。