文档中心

数美 API

取消或删除3D生成任务

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

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

快速入口

鉴权说明

体验中心

模型列表

模型计费

API Key

接口文档

常见问题

开通模型

请求参数

跳转响应参数

说明

该参数为 Path Parameter。您需要将待查询的 3D 生成任务的 ID，直接替换 URL 中的 {id} 占位符。

id string 必选（通过创建 3D 生成任务接口获取）

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

任务状态不同，调用 DELETE 接口，执行的操作有所不同，具体说明如下：

当前任务状态	支持DELETE操作	操作含义	DELETE操作后任务状态
queued	是	任务取消排队，任务状态被变更为 cancelled。	cancelled
running	不支持	-	-
succeeded	是	删除 3D 生成任务记录，后续将不支持查询。	-
failed	是	删除 3D 生成任务记录，后续将不支持查询。	-
cancelled	不支持 24小时后自动删除	-	-

响应参数

跳转请求参数

本接口无返回参数。

默认

输入示例

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"

输出示例

{}

最近更新时间：2026.08.21 11:18:10

这个页面对您有帮助吗？

有用

无用

火山方舟