Seedance 系列

字節跳動的影片生成模型，共四款，透過 OfoxAI 影片介面 POST /v1/videos 呼叫。任務以非同步方式執行：建立任務後取得任務 ID，再透過該 ID 查詢結果。

模型選擇

重點需要 4K 輸出時選用 2.0；需要 30 秒時長或 21:9 畫面比例時選用 2.5；批次生成 480p、720p 影片時選用 Mini 或 Fast。

模型	解析度（預設）	時長	畫面比例
Seedance 2.5	`480p` `720p` `1080p`（`720p`）	4–30 秒	`21:9` `16:9` `4:3` `1:1` `3:4` `9:16` `adaptive`
Seedance 2.0	`480p` `720p` `1080p` `4k`（`1080p`）	4–15 秒	`16:9` `9:16` `1:1` `adaptive`
Seedance 2.0 Fast	`480p` `720p`（`720p`）	4–15 秒	同 2.0
Seedance 2.0 Mini	`480p` `720p`（`720p`）	4–15 秒	同 2.0

四款皆支援文生影片、圖生影片與影片參考，並可生成同步音軌（generate_audio 預設為 true）。adaptive 表示沿用輸入圖片的比例。

模型 ID（呼叫時原樣複製）

Seedance 2.5bytedance/seedance-2.530 秒、21:9

Seedance 2.0bytedance/seedance-2.04K

Seedance 2.0 Fastbytedance/seedance-2.0-fast480p、720p

Seedance 2.0 Minibytedance/seedance-2.0-mini480p、720p

上表與 Models API 返回的 video_attributes 一致；模型能力如有調整，以介面返回為準。按秒計費，實際費用以任務結果中的 usage.video_cost 為準，價格請參閱模型頁。

請明確傳入 resolution 與 duration。 未傳入時 2.0 預設為 1080p，費用按解析度級距計算，高於 720p。

呼叫範例

重點五種生成模式共用一個介面，由傳入的素材欄位決定模式，不需指定模式參數。

以下範例只展示建立任務的請求。建立後查詢狀態、下載結果的完整流程見 Video API · 快速開始。

文生影片

僅傳 prompt。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "一隻狐狸在雪地裡奔跑，鏡頭跟隨",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

圖生影片

frame_images 傳入 1 張 first_frame，影片以該圖片作為首幀。畫面比例可設為 adaptive，沿用圖片比例。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "畫面中的狗朝鏡頭奔跑",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

首尾幀

frame_images 傳入 first_frame 與 last_frame，生成兩幀之間的過渡。僅傳 last_frame 會返回 400。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "花苞緩緩綻放成一朵盛開的玫瑰",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

參考圖

input_references 傳入圖片（最多 9 張），用於保持人物、商品或風格一致，不作為固定畫面。建議在提示詞中以「圖 1」「圖 2」指稱各圖片。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "圖 1 的女孩拿著圖 2 的杯子，在咖啡館窗邊微笑",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

音視訊參考

input_references 可混合傳入圖片、音訊（最多 3 段，每段不超過 15 秒）與影片（最多 1 段）。以影片為輸入時，計費秒數可能包含輸入影片的時長。

Terminal


curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "角色以這段配音的語氣說話，鏡頭風格參考這段影片",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

frame_images 與 input_references 不可同時傳入，同時傳入返回 400 references_conflict。
圖片可使用公開網路 URL，也可使用以 data:image/...;base64, 開頭的字串。
不需要音軌時傳入 "generate_audio": false。
欄位結構的完整說明見建立影片任務。

真人參考圖

重點透過 OfoxAI 呼叫時，不需完成 Seedance 的素材庫驗證，在請求最上層加入 real_person: true 即可。

字節官方的 Seedance 介面不允許直接上傳含真人臉孔的參考圖或影片。BytePlus Seedance 2.0 官方文件要求使用已授權的真人人像素材，火山方舟真人人像庫指南列出了發起邀請、本人驗證授權、上傳素材、接收授權並取得素材 ID 等步驟。

步驟	直連 Seedance 官方介面	透過 OfoxAI 呼叫
首次請求前	建立素材群組、完成真人驗證與授權、上傳並校驗素材、取得素材 ID	不需在供應商平台預先入庫
參考圖傳參	使用已生效的授權素材 `asset://<asset_id>`	在 `frame_images` 或 `input_references` 中傳入圖片 URL 或 `data:` URI
請求開關	改用審核通過的素材 URI	請求最上層加入 `"real_person": true`


{
  "model": "bytedance/seedance-2.0",
  "prompt": "畫面中的人物走過電影感夜市",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

OfoxAI 會在提交前對參考圖進行隱私預處理，可減少上游反深偽審核的誤拒，但不能保證上游一定接受；遭上游拒絕的任務不計費。
real_person 是處理指令，不是授權證明。請僅提交依法有權且已獲授權使用的圖片。
圖片仍遭拒時的調整方法與預處理錯誤碼，見真人參考圖。

指定供應商

重點Seedance 由兩家供應商承載，審核尺度不同；不指定時由閘道按權重分流。

供應商	說明	內容審核
`volcengine`	火山引擎方舟，字節跳動中國大陸平台	標準審核
`byteplus`	BytePlus，字節跳動海外平台	允許不適合所有受眾（NSFW）的內容

需要固定供應商時，在請求最上層加入：


"provider": { "type": "byteplus" }

需要生成不適合所有受眾的內容時，必須明確指定 byteplus。未指定時請求可能被分流至 volcengine，並因內容審核遭拒。指定供應商後，若該供應商無法使用，請求不會自動切換。

provider.type 的取值錯誤返回 400 invalid_provider_type；指定的供應商未承載該模型返回 400 provider_type_unavailable。通用說明見影片供應商路由。

常見錯誤

重點參數校驗錯誤在建立時即返回，不會建立任務，也不產生費用。錯誤訊息中會列出允許的取值。

HTTP · code	錯誤原文	原因	處理方法
400 `unsupported_parameter`	`duration 3 out of range [4, 15]`	時長超出該模型範圍	2.0 系列為 4–15 秒，2.5 為 4–30 秒
400 `unsupported_parameter`	`resolution "1080p" not supported; allowed: [480p 720p]`	Fast、Mini 不支援 1080p	改用 `720p`，或改用 2.0 / 2.5
400 `unsupported_parameter`	`resolution "4k" not supported; allowed: [480p 720p 1080p]`	僅 2.0 支援 4K	改用 `bytedance/seedance-2.0`
400 `unsupported_parameter`	`aspect_ratio "21:9" not supported; allowed: [16:9 9:16 1:1 adaptive]`	2.0 系列不支援 21:9	改用 2.5，或改用支援的比例
400 `references_conflict`	`frame_images and input_references are mutually exclusive`	同時傳入了兩種素材欄位	兩者只能擇一，見呼叫範例
400 `invalid_request`	`frame_images: last_frame requires a first_frame`	僅傳入了尾幀	補上 `first_frame`
400 `too_many_references`	`input_references over limit: images 10/9, audios 0/3, videos 0/1`	參考素材超過上限	圖片最多 9 張、音訊最多 3 段、影片最多 1 段
400 `invalid_request`	`real_person requires at least one image reference`	啟用了 `real_person` 但未傳入圖片	補上圖片，或移除 `real_person`
400 `invalid_request`	`cannot unmarshal string into Go struct field CreateVideoRequest.duration of type int`	`duration` 傳入了字串，如 `"5s"`	改為整數，如 `5`
400 `invalid_callback_url`	`callback_url must be a public HTTPS URL`	回呼位址不是 HTTPS，或為內網位址	改為公開網路的 HTTPS 位址
404 `model_not_found`	`model not found`	模型 ID 拼寫錯誤，如 `bytedance/seedance-2`	從本頁複製模型 ID
402 `insufficient_credits`	—	餘額不足以支付預估費用（任務不會被建立）	儲值後重試

任務建立成功後若在生成階段失敗，查詢結果為 status: "failed"，失敗原因見 error 欄位；逾時對應 error.code: "expired"。完整錯誤碼見 Video API 錯誤碼。

官方文件

常見問題

Seedance 怎麼做首尾幀影片？

在 frame_images 中傳入兩張圖片，一張 frame_type 為 first_frame，一張為 last_frame。只傳 last_frame 會返回 400 last_frame requires a first_frame。frame_images 不能和 input_references 同時傳。

Seedance 2.0 支援 4K 嗎？

只有 bytedance/seedance-2.0 支援 4k。2.5 最高 1080p，Fast 和 Mini 最高 720p，傳入不支援的解析度會返回 400，錯誤訊息中會列出允許的取值。

Seedance 最長能生成多少秒？

Seedance 2.5 單個任務 4 至 30 秒，2.0、2.0 Fast、2.0 Mini 為 4 至 15 秒。超出範圍返回 400 duration out of range。

Seedance 支援 21:9 嗎？

只有 Seedance 2.5 支援 21:9。2.0 系列只支援 16:9、9:16、1:1 和 adaptive。

Seedance 參考圖裡有真人而報錯怎麼辦？

直連官方需要先在素材庫完成本人驗證。透過 OfoxAI 呼叫，在請求最上層加上 real_person: true 即可直接傳圖，OfoxAI 會先做隱私預處理。仍遭上游拒絕時不計費，可依真人參考圖頁面的建議調整圖片後重試。

Seedance 一次最多能傳幾張參考圖？

input_references 最多 9 張圖片、3 段音訊（每段不超過 15 秒）、1 段影片。超出返回 400 too_many_references。

Seedance 影片生成後的位址多久失效？

優先使用 mirror_urls。只返回 unsigned_urls 時，那是上游的暫時位址，可能 24 小時後失效，請及時下載保存。