API字节跳动Seedance 系列模型
取消任务
取消排队中的任务或隐藏终态任务。
请求
DELETE /ai/api/v3/contents/generations/tasks/{id}
Authorization: Bearer <TUIWO_API_TOKEN>{id} 可以是 id 或 task_id。
行为
- 终态任务:从客户可见列表中隐藏;平台保留计费与审计记录。
- 排队任务:受平台开关与平台能力限制。
- 生成中的任务:返回
409 TaskNotCancellable。 - 不支持的模型服务或未开启取消能力:返回
501 NotImplemented。 - 取消成功后的退款是异步的,可能稍后才完成。
错误
| HTTP | code | 说明 |
|---|---|---|
| 404 | NotFound | 任务不存在或不属于当前用户/分组 |
| 409 | TaskNotCancellable | 任务运行中或无法取消 |
| 409 | CancelUnconfirmed | 服务端未确认取消 |
| 409 | RefundPending | 任务已失败,退款仍在处理 |
| 501 | NotImplemented | 当前配置不支持取消 |
| 502 | TaskServiceUnavailable | 服务端取消请求失败 |