FocalAPI Docs
API 参考视频创作

取消视频生成任务

DELETE
/v1/video/generations/{task_id}

取消排队中的视频生成任务,成功返回 { "id": "...", "status": "cancelled", "cancelled": true },费用自动退还。

  • 409 task_already_running: 任务已开始生成,无法取消
  • 409 task_already_finished: 任务已结束,无需取消
  • 404 task_not_found: 任务不存在或不属于当前 Key
  • 502 task_cancel_failed: 上游取消失败,可稍后重试

Authorization

BearerAuth
AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Path Parameters

task_id*string

任务 ID

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/video/generations/string"
{  "id": "string",  "status": "cancelled",  "cancelled": true}