跳转到主要内容
OrcaRouter 在与 Kling 相同的提交-轮询端点上支持 Seedance 视频模型。 你发送 model: byteplus/dreamina-seedance-2-0-260128，OrcaRouter 会把请求路由到上游 Ark 的 /contents/generations/tasks API，完成后 你通过同一个任务 ID 回到 OrcaRouter 轮询（视时长 / 分辨率 / generate_audio 而定，通常 30 秒到 4 分钟）。
当前可用的模型。 目前仅 Seedance 2.0 已开通，后端名为 byteplus/dreamina-seedance-2-0-260128。下表列出 Seedance 家族 其余成员供参考，但它们尚未在 playground 中可选、也尚未在 OrcaRouter 上可路由——当前所有请求请使用 byteplus/dreamina-seedance-2-0-260128。
提交端点 POST /v1/video/generations 和获取端点 GET /v1/video/generations/{task_id} 与 Kling 共用。变化的是请求体：Kling 用 prompt + image + metadata.{mode, aspect_ratio, image_list, ...}，Seedance 用 prompt + metadata.{content[], ratio, duration, generate_audio, watermark, ...}。 由 model 前缀选择哪种 schema 被解读。

​
模型

模型T2VI2V（首）I2V（首+尾）多模态参考¹视频编辑²生成音频³时长可用
byteplus/dreamina-seedance-2-0-260128（2.0）✓✓✓✓ 完整✓✓4 – 15 s✓
byteplus/seedance-2.0-fast✓✓✓✓ 完整✓✓4 – 15 s计划中
byteplus/seedance-1-5-pro✓✓✓仅图像✓4 – 12 s计划中
byteplus/seedance-1-0-pro✓✓✓仅图像2 – 12 s计划中
byteplus/seedance-1-0-pro-fast✓✓仅图像2 – 12 s计划中
byteplus/seedance-1-0-lite-i2v✓✓仅图像2 – 12 s计划中
byteplus/seedance-1-0-lite-t2v✓仅图像2 – 12 s计划中
¹ 多模态参考 = metadata.content[] 数组可携带带 role 标记的 image_url / video_url / audio_url 项（reference_image / reference_video / reference_audio）。“完整”意味着图像 + 视频 + 音频的任意组合都被接受。 ² 视频编辑 = 传一个 video_url 内容项以基于 prompt 对源视频做编辑 （主体替换、区域重绘等）。 ³ 原生音频 = 上游自动生成与视频匹配的配乐。通过 metadata.generate_audio: true 切换。 每个模型的提交端点都是 POST /v1/video/generations。变化的是上游 按上表认可哪些 metadata 字段。各模型的权威能力清单见上游 Seedance 能力矩阵。

​
提交任务

向 /v1/video/generations 发 POST，携带 model、prompt，以及上游 特定的参数（放在 metadata 下）： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "A girl holding a fox, the girl opens her eyes, looks gently at the camera, the fox hugs affectionately, the camera slowly pulls out, the girl'\''s hair is blown by the wind",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/foxgirl.png" } }
      ],
      "ratio": "16:9",
      "duration": 5,
      "generate_audio": true,
      "watermark": false
    }
  }'
响应携带任务 ID（与 Kling 同样的信封——OrcaRouter 在跨服务商之间 归一化）： 
{
  "id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
  "task_id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
  "object": "video",
  "model": "byteplus/dreamina-seedance-2-0-260128",
  "status": "queued",
  "progress": 0,
  "created_at": 1777975188
}
OrcaRouter 会自动把你的 prompt 作为 Seedance content[] 数组里的 text 项包好——你不需要自己传 {type: "text"} 项。你在 metadata.content[] 中提供的任何 text 项都会被顶层 prompt 替换。 其他内容项（image_url、video_url、audio_url）原样透传。

​
请求体字段

下列字段都放在 metadata 中。按下方变体表组合即可。
字段类型说明
contentarray多模态参考项。每项：{type, image_url? | video_url? | audio_url?, role?}。纯文生视频可省略。
ratiostring宽高比。16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive。adaptive 由输入推断。
durationinteger秒数。允许范围因模型而异——见上表。
resolutionstring480p / 720p / 1080p。默认 720p。1080p 仅在 seedance-2.0 / seedance-2.0-fast / seedance-1-5-pro / seedance-1-0-pro / seedance-1-0-pro-fast 上可用。
generate_audioboolean自动生成同步配乐。默认 false。仅在 seedance-2.0 / 2.0-fast / 1-5-pro 上可用。
watermarkboolean在生成视频上打上上游水印。默认由上游决定。
seedinteger用于可复现的随机种子。
service_tierstringdefault（在线）或 flex（离线 / 低优先级、更高配额）。默认 default。
return_last_frameboolean在 MP4 之外另返回最后一帧作为图像。默认 false。
callback_urlstringWebhook URL —— 接收状态变化（替代或并行轮询）。

​
content[] 项形态

metadata.content 中每个项有四种形态之一： 
{ "type": "image_url", "image_url": { "url": "https://..." }, "role": "first_frame" }
{ "type": "video_url", "video_url": { "url": "https://..." }, "role": "reference_video" }
{ "type": "audio_url", "audio_url": { "url": "https://..." }, "role": "reference_audio" }
{ "type": "text",      "text": "..." }    // 会被顶层 prompt 自动替换
role 可选值：
role用途
first_frame把该图像锚定为生成视频的首帧。
end_frame把该图像锚定为最后一帧（与 first_frame 配合用于首+尾帧 i2v）。
reference_image风格 / 主体参考（多模态参考变体；可传多张）。
reference_video风格 / 运动参考，或源视频（用于编辑 / 续生成）。
reference_audio背景音乐或人声参考（音视频联合生成）。
在 prompt 中以 [Image 1]、[Video 1]、[Audio 1] 语法引用参考项。 索引按数组顺序（1 起，按类型分别计数）。

​
轮询结果

使用提交时返回的任务 ID： 
curl https://api.orcarouter.ai/v1/video/generations/task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw \
  -H "Authorization: Bearer sk-orca-..."
响应形态是包裹后的（与 Kling 一致）： 
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_9q9oz6tjtgABYWC1QIqoz3sscgVz7ycw",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://ark-content-generation-ap-southeast-1.tos-ap-southeast-1.volces.com/.../video.mp4",
    "submit_time": 1777975188,
    "start_time": 1777975241,
    "finish_time": 1777975277,
    "fail_reason": ""
  }
}
各服务商间的状态值统一为大写：
状态上游 Seedance 状态含义
NOT_START（瞬态）任务行已创建，尚未派发
SUBMITTEDqueued已发送给上游，在队列中等待
IN_PROGRESSrunning上游正在渲染
SUCCESSsucceeded完成。data.result_url 携带 MP4
FAILUREfailed失败。data.fail_reason 给出原因
进度是百分比字符串（"50%"、"100%"），不是整数。 每 5 - 10 秒轮询一次。720p 5 秒短片通常 30 - 60 秒完成；1080p 加音频 或 15 秒 / 多模态参考短片可能要 3 - 5 分钟。 result_url 是上游签名的、TTL 较短的 TOS URL——如果你需要长期保留， 请及时下载或转存。

​
端点变体

所有变体共用 POST /v1/video/generations。Seedance 实际承接哪条 特性路径由 metadata.content[] 项与 role 标记决定——不是 URL。

​
文生视频

只要 model + prompt + 可选 metadata。没有 content 项即为纯文生 视频： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Photorealistic style: under a clear blue sky, a vast expanse of white daisy fields stretches out. The camera gradually zooms in on a single daisy with glistening dewdrops on its petals.",
    "metadata": {
      "ratio": "16:9",
      "duration": 5,
      "watermark": true
    }
  }'

​
图生视频 —— 首帧

传一个 role: "first_frame" 的图像项： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "the cat starts dancing energetically",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/cat.png" }, "role": "first_frame" }
      ],
      "ratio": "adaptive",
      "duration": 5,
      "generate_audio": true
    }
  }'

​
图生视频 —— 首尾帧

两个图像项，分别用作 first_frame 和 end_frame： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Create a 360-degree orbiting camera shot from start to end frame.",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/start.jpg" }, "role": "first_frame" },
        { "type": "image_url", "image_url": { "url": "https://example.com/end.jpg" },   "role": "end_frame"   }
      ],
      "ratio": "16:9",
      "duration": 6
    }
  }'

​
多模态参考 —— 图 + 视频 + 音频

组合 reference_image / reference_video / reference_audio 项。 在 prompt 里用 [Image N] / [Video N] / [Audio N] 索引引用 （1 起，按类型分别计数）： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Use the first-person POV framing from [Video 1] throughout, and use [Audio 1] as the background music. First-person POV fruit tea promotional ad: [Image 1] hands pick a dew-covered apple; [Image 2] holds the finished drink up to the camera.",
    "metadata": {
      "content": [
        { "type": "image_url", "image_url": { "url": "https://example.com/tea_pic1.jpg" }, "role": "reference_image" },
        { "type": "image_url", "image_url": { "url": "https://example.com/tea_pic2.jpg" }, "role": "reference_image" },
        { "type": "video_url", "video_url": { "url": "https://example.com/tea_video1.mp4" }, "role": "reference_video" },
        { "type": "audio_url", "audio_url": { "url": "https://example.com/tea_audio1.mp3" }, "role": "reference_audio" }
      ],
      "ratio": "16:9",
      "duration": 11,
      "generate_audio": true,
      "watermark": false
    }
  }'
仅在 seedance-2.0 和 seedance-2.0-fast 上支持完整的图 + 视频 + 音频组合；seedance-1-5-pro 与 seedance-1-0-* 只接受 reference_image 项。

​
视频编辑 / 续生成

传 {type: "video_url", role: "reference_video"} 并在 prompt 里要求 修改或延续该视频： 
curl https://api.orcarouter.ai/v1/video/generations \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "byteplus/dreamina-seedance-2-0-260128",
    "prompt": "Change all the fruits in [Video 1] into fresh fruits.",
    "metadata": {
      "content": [
        { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" }, "role": "reference_video" }
      ],
      "ratio": "adaptive",
      "duration": 6
    }
  }'
仅在 seedance-2.0 和 seedance-2.0-fast 上可用。

​
Webhooks

传 metadata.callback_url: "https://your.domain/webhook" 即可在任务 切换到 SUCCESS 或 FAILURE 时收到一次 POST。载荷镜像轮询的响应。 如果你同时启用轮询和回调，两者都会触发——它们相互独立。

​
计费

OrcaRouter 透传上游每个任务的 token 费用，零加价。最终成本与 ByteDance Ark 公布的费率表一致（任务结果里的上游 completion_tokens / total_tokens 按你 Channel Margin 配置里设定 的逐 token 费率换算为配额）。 提交时会预留一小笔预消费冻结；任务成功时差额结算。详见 运维 / 计费与用量。

​
另见