跳轉到主要內容
POST
/
volc
/
v3
/
contents
/
generations
/
tasks
curl --request POST \
  --url https://api.cometapi.com/volc/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1-5-pro-251215",
  "content": [
    {
      "type": "text",
      "text": "A paper boat drifts on a quiet lake at sunrise. --duration 5 --ratio 16:9"
    }
  ]
}
'
{
  "id": "021773297205999example"
}
使用此端點可從文字,或從文字加上參考圖片,啟動 ByteDance Seedance 影片任務。請求會立即回傳 task id,而渲染會以非同步方式持續進行。

選擇目前的模型路徑

  • 請使用Models 頁面查看目前可用的模型與識別碼。
  • 對於此路由,請使用 doubao-seedance-1-5-pro-251215 作為目前正式環境範例。
  • 相同的目前模型可透過統一的 content 陣列同時處理純文字與圖片引導請求。

任務流程

1

建立 content 陣列

先放入主要文字指令,只有在你需要首幀或尾幀引導時才加入圖片項目。
2

提交任務

請保存回傳的 task id。若你想要推送式交付,請在建立任務時設定 callback_url
3

輪詢直到輸出完成

呼叫 ByteDance 影片查詢,直到任務完成且出現 content.video_url

已知封裝行為

Volcengine 與 Seedance 將此系列記錄為先建立再查詢的非同步工作流程。CometAPI 保留相同的任務模式,但提供單一 base URL 與單一 API key。
在 2026-03-12 的即時驗證期間,此路由可連線,但對標準 JSON 範例仍回傳伺服器端 JSON 剖析錯誤。請將此處的 OpenAPI 範例視為實務上的封裝參考,並在開發初期就先驗證你的 payload。

授權

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

主體

application/json
model
string
必填

ByteDance Seedance video model id. Choose a current model from the Models page. A current production example is doubao-seedance-1-5-pro-251215, which supports both text-only and image-guided requests through the same content array.

範例:

"doubao-seedance-1-5-pro-251215"

content
object[]
必填

Ordered input items for the task. Put the main text instruction first. Add image items when you need first-frame or last-frame guidance.

callback_url
string

Optional webhook URL for task status notifications.

回應

200 - application/json

Task accepted.

id
string
必填

Task id for later polling.