Skip to main content

​
概覽

這些介面面向已經使用火山風格 Seedance 任務結構的團隊。鑑權使用 TokenLab Bearer API Key。返回的任務 ID 以 cgt- 開頭；請輪詢狀態介面，直到 status 變為 succeeded、failed、cancelled 或 expired。 官方任務契約使用 /api/v3/contents/generations/tasks 下的 REST 路徑。既有 Action 別名只為舊版 TokenLab 整合保留，不屬於官方線級相容契約。 callback_url 可填寫公網 HTTP(S) 地址。每次狀態變為 queued、running、succeeded、failed 或 expired 時，TokenLab 都會發送與查詢介面完全相同的物件，而且不附加 TokenLab 私有 header；succeeded 與 failed 會在五秒後最多重試三次。
為了在斷線後安全找回任務，REST 建立請求應攜帶唯一的 Idempotency-Key。使用相同 body 和 key 重試會返回同一個 cgt-... ID；同一 key 搭配不同 body 會返回 409。舊版 Action 路徑不包含此能力。
另見 Seedance 2.0 影片模型 和 影片生成.

​
內容規則

  • type=text 用於提示詞文字。
  • type=image_url 不傳 role 時按首幀處理，也可以明確傳 role=first_frame。
  • role=last_frame 必須和首幀一起使用。
  • role=reference_image、reference_video、reference_audio 用於參考素材。
  • 同一個請求中不要混用首尾幀輸入和參考素材。

​
參數說明

  • ratio 支援 16:9、4:3、1:1、3:4、9:16、21:9 或 adaptive。
  • generate_audio 的官方預設值為 false；需要同步音訊時傳 true。
  • service_tier=default 可用。Seedance 2.0 相容任務會拒絕 service_tier=flex、frames 和 camera_fixed=true。
  • 當所選模型支援時，tools 可以傳入類似 { "type": "web_search" } 的物件。格式錯誤的 tool 項會被拒絕，而不是靜默忽略。

​
範例