MiniMax H3 · MiniMax 格式

取消视频生成任务

取消排队中的任务，冻结的费用全部退回。请求方式和返回结果与 MiniMax「取消或删除视频生成任务」（视频生成 V2）接口一致。

DELETEhttps://your-domain/minimax/v2/video_generation/{task_id}

请求示例

curl -X DELETE https://your-domain/minimax/v2/video_generation/video_8f3k2m9x4q1w7e5r0t6y2u4p \
  -H "Authorization: Bearer $MINIMAX_API_KEY"

返回结果（取消成功）

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

返回结果（任务已开始生成）

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "任务已经开始处理，不能取消 (2013)",
    "http_code": "400"
  },
  "request_id": "5oAolP1vT0aPGNVd"
}

请求参数

路径参数

task_idstring必填

要取消的任务 ID。

返回参数

取消成功时返回 HTTP 200，任务状态变成 cancelled，冻结的费用全部退回。传了 callback_url 的任务会收到一次 cancelled 推送。

task_idstring

任务 ID。

actionstring

执行的操作，固定为 cancelled（已取消）。

statusstring

任务现在的状态，固定为 cancelled。

不能取消时返回 HTTP 400 bad_request_error，message 说明原因。暂时无法取消时返回 HTTP 500 server_error，可以稍后重试。

各状态的处理

任务状态	本平台	MiniMax
`queued`	取消任务，状态变成 cancelled，费用退回	取消任务
`running`	不能取消，返回 400	不能取消
`succeeded`、`failed`、`cancelled`	不删除任务，返回 400	删除任务记录

排队中的任务如果已经交给模型处理、无法撤回，同样返回 400，任务会继续生成，成功后正常扣费。
已结束的任务和视频会一直保留，可以继续查询和下载，也能在控制台 → 视频任务里看到。
取消接口每个账号每分钟最多调用 120 次。