跳轉到主要內容
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（首+尾）多模態參考1視頻編輯2生成音頻3時長可用
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計劃中
1 多模態參考 = metadata.content[] 數組可攜帶帶 role 標記的 image_url / video_url / audio_url 項（reference_image / reference_video / reference_audio）。“完整”意味著圖像 + 視頻 + 音頻的任意組合都被接受。 2 視頻編輯 = 傳一個 video_url 內容項以基于 prompt 對源視頻做編輯 （主體替換、區域重繪等）。 3 原生音頻 = 上游自動生成與視頻匹配的配樂。通過 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 費率換算為配額）。 提交時會預留一小筆預消費凍結；任務成功時差額結算。詳見 運維 / 計費與用量。

​
另見