ビデオと素材

タスクのキャンセル (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キー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

id*string

作成エンドポイントによって返される互換タスクID。IDはcgt-で始まります。

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json