开发者文档取消 / 删除任务

取消 / 删除任务

H3 视频任务 API · /api/v3

请求地址

DELETEhttps://fablun.com/api/v3/contents/generations/tasks/{id}

取消尚未提交模型执行的任务,或删除已结束任务。取消 / 删除限额为同一账户共享 20 QPS。

请求与响应

cURL
curl -X DELETE 'https://fablun.com/api/v3/contents/generations/tasks/cgt-0123456789abcdef0123456789abcdef' \
  -H "Authorization: Bearer $ARK_API_KEY"
HTTP 200 · application/json
{}

允许的操作

状态行为
queued取消任务,停止后续执行。
cancelled重复取消返回 HTTP 200 和 {},不重复返还额度。
running仅输入准备阶段、尚未提交模型时可能取消;已提交推理返回 409。
succeeded / failed / expired删除对外任务记录,已有视频链接失效。
取消、失败或超时不产生成功费用。删除任务不会撤销已成功视频的月结费用。