Seedance · 火山方舟格式
取消视频生成任务
取消排队中的任务，冻结的费用全部退回。请求方式和返回结果与火山方舟「取消或删除视频生成任务」接口一致。
DELETEhttps://your-domain/ark/api/v3/contents/generations/tasks/{id}
请求参数
路径参数
idstring必填
要取消的任务 ID。
返回结果
取消成功时返回 HTTP 204，没有响应体。任务状态变成 cancelled，冻结的费用全部退回；主动取消的任务不发送回调。
不能取消时返回 HTTP 400，错误码 InvalidAction，message 说明原因。暂时无法取消时返回 HTTP 500 InternalServiceError，可以稍后重试。
各状态的处理
| 任务状态 | 本平台 | 火山方舟 |
|---|---|---|
queued | 取消任务，状态变成 cancelled，费用退回 | 取消任务 |
running | 不能取消，返回 400 InvalidAction | 不能取消 |
succeeded、failed、expired | 不删除任务，返回 400 InvalidAction | 删除任务记录 |
cancelled | 返回 400 InvalidAction | 不支持 |
- 排队中的任务如果已经交给模型处理、无法撤回，同样返回 400 InvalidAction，任务会继续生成，成功后正常扣费。
- 已结束的任务和视频会一直保留，可以继续查询和下载，也能在控制台 → 视频任务里看到。
- 取消接口每个账号每分钟最多调用 120 次。