Skip to content
Request
Response

Cancel or Delete Video Generation Task API ​

Cancel a queued video generation task, or delete a video generation task record.

Request Information ​

ItemValue
Request MethodDELETE
Request URLhttps://ai-tokenhub.com/api/v3/contents/generations/tasks/id
Content-Typeapplication/json
AuthenticationAPI Key Authentication (Bearer Token)

Request Headers ​

Field NameRequiredDescription
Authorization✓Format: Bearer <$YOUR_API_KEY>, same API key used for task creation
Content-Type✓Fixed value: application/json

Request Parameters ​

Path Parameters ​

id string Required

The video generation task to be cancelled or deleted.

Depending on the task status, calling the DELETE interface performs different operations, as detailed below:

Current Task StatusDELETE SupportedOperation MeaningTask Status After DELETE
queuedYesTask is cancelled from queue, task status is changed to cancelled.cancelled
runningNo--
succeededYesDelete video generation task record, no longer queryable.-
failedYesDelete video generation task record, no longer queryable.-
cancelledNo--
expiredYesDelete video generation task record, no longer queryable.-

Response Parameters ​

This interface has no return parameters.