Skip to Content
模型用法Seedance

Seedance 系列

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

模型選擇

重點需要 4K 輸出時選用 2.0；需要 30 秒時長或 21:9 畫面比例時選用 2.5；批次生成 480p、720p 影片時選用 Mini 或 Fast。
模型解析度（預設）時長畫面比例
Seedance 2.5480p 720p 1080p（720p）4–30 秒21:9 16:9 4:3 1:1 3:4 9:16 adaptive
Seedance 2.0480p 720p 1080p 4k（1080p）4–15 秒16:9 9:16 1:1 adaptive
Seedance 2.0 Fast480p 720p（720p）4–15 秒同 2.0
Seedance 2.0 Mini480p 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.ai/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 與 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火山引擎方舟，字節跳動中國大陸平台標準審核
byteplusBytePlus，字節跳動海外平台允許不適合所有受眾（NSFW）的內容

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

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

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

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

常見錯誤

重點參數校驗錯誤在建立時即返回，不會建立任務，也不產生費用。錯誤訊息中會列出允許的取值。
HTTP · code錯誤原文原因處理方法
400 unsupported_parameterduration 3 out of range [4, 15]時長超出該模型範圍2.0 系列為 4–15 秒，2.5 為 4–30 秒
400 unsupported_parameterresolution "1080p" not supported; allowed: [480p 720p]Fast、Mini 不支援 1080p改用 720p，或改用 2.0 / 2.5
400 unsupported_parameterresolution "4k" not supported; allowed: [480p 720p 1080p]僅 2.0 支援 4K改用 bytedance/seedance-2.0
400 unsupported_parameteraspect_ratio "21:9" not supported; allowed: [16:9 9:16 1:1 adaptive]2.0 系列不支援 21:9改用 2.5，或改用支援的比例
400 references_conflictframe_images and input_references are mutually exclusive同時傳入了兩種素材欄位兩者只能擇一，見呼叫範例
400 invalid_requestframe_images: last_frame requires a first_frame僅傳入了尾幀補上 first_frame
400 too_many_referencesinput_references over limit: images 10/9, audios 0/3, videos 0/1參考素材超過上限圖片最多 9 張、音訊最多 3 段、影片最多 1 段
400 invalid_requestreal_person requires at least one image reference啟用了 real_person 但未傳入圖片補上圖片，或移除 real_person
400 invalid_requestcannot unmarshal string into Go struct field CreateVideoRequest.duration of type intduration 傳入了字串，如 "5s"改為整數，如 5
400 invalid_callback_urlcallback_url must be a public HTTPS URL回呼位址不是 HTTPS，或為內網位址改為公開網路的 HTTPS 位址
404 model_not_foundmodel 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 小時後失效，請及時下載保存。

最後更新於
MAI ImageWan 與 HappyHorse