EcoPhase Docs - Cancel or delete a video generation job

Use DELETE /v2/video_generation/{task_id} to cancel a job or remove a terminal job from the compatibility view. The endpoint never physically deletes control-plane audit records or object-store artifacts.

Request

curl -X DELETE "https://ecotoken.ecophase-ai.com/v2/video_generation/YOUR_TASK_ID" \
  -H "Authorization: Bearer $VIDEO_API_KEY" \
  -H "Idempotency-Key: $VIDEO_DELETE_IDEMPOTENCY_KEY"

Create the idempotency key once per logical cancel/delete operation. If the outcome is unknown, retry with the same key; use a new key for a different operation.

State semantics

Current status	Behavior
`queued`	Sends a real cancellation to the video control plane and returns `action: "cancelled"`
`running`	Rejects cancellation with `400`; execution continues
`cancelled`	Cannot be cancelled or deleted again and returns `400`
`succeeded`, `failed`	Logically deletes the task from the MiniMax-H3 compatibility list and returns `action: "deleted"`

After a terminal task is removed, it no longer appears in the account's compatibility view.

Response

{
  "task_id": "YOUR_TASK_ID",
  "action": "cancelled",
  "status": "cancelled"
}

action is cancelled or deleted. A missing, cross-tenant, running, or already cancelled job returns 400; an invalid or revoked key returns 401.