# 取消或删除3D生成任务

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

`DELETE https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}`

取消排队中的影眸 3D 生成任务，或者删除影眸 3D 生成任务记录。

## 鉴权

本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](/docs/base-url-and-authentication)。

* API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。

---

<span id="request-parameters"></span>
## 请求参数

### Path 参数

**id** `string` `必选` | 任务 ID

需要取消或者删除的影眸 3D 生成任务 ID。

任务状态不同，调用 `DELETE` 接口执行的操作不同：

| 当前任务状态 | 是否支持 DELETE 操作 | 操作含义 | DELETE 操作后任务状态 |
| --- | --- | --- | --- |
| `queued` | 是 | 任务取消排队，任务状态变更为 `cancelled` | `cancelled` |
| `running` | 否 | — | — |
| `succeeded` | 是 | 删除任务记录，后续不再支持查询 | — |
| `failed` | 是 | 删除任务记录，后续不再支持查询 | — |
| `cancelled` | 否，24 小时后自动删除 | — | — |

## 响应参数

本接口无特有的返回参数，成功时 HTTP 状态码为 `200`，返回结构中 `Result` 为空对象 `{}`。


## 代码示例

## 默认

### cURL


#### Request

```bash
TASK_ID="your_task_id"
curl -X DELETE "https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/$TASK_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY"
```
#### Response

```
{}
```