TokenLab

視頻與素材

取消任務 (Volc 相容)

取消已排隊或可取消的 Seedance 相容任務。

DELETE
/api/v3/contents/generations/tasks/{id}

概覽

只有在任務仍處於 queued 狀態時,取消操作才會成功。成功的 DELETE 請求會回傳 HTTP 200 並帶有空主體。請在操作後查詢任務以確認最終狀態。

請參閱 Seedance 2.0 影片模型 與 影片生成。

取消語義

  • 請求僅在任務處於 queued 狀態時才能成功。
  • 如果任務已經處於 running 狀態,或者已完成、失敗或過期,該端點將回傳 409 並附帶 task_not_cancellable 代碼;請查詢任務以確認其當前狀態。
  • 已取消的任務狀態為 cancelled,且不會回傳影片結果。
  • 若任務 ID 不存在,則回傳 404。

範例

curl -X DELETE https://api.tokenlab.sh/api/v3/contents/generations/tasks/cgt-20260102030405-a1b2c \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"
curl -X DELETE "https://example.com/api/v3/contents/generations/tasks/string"
空

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

路徑參數

id*string

由建立端點回傳的相容性任務 ID。ID 以 cgt- 開頭。

回應

application/json

application/json

application/json

application/json

application/json

application/json