删除主体
更新时间：2026-03-06
POST
https://qianfan.baidubce.com/beta/aigc/qianfan-delete-elements
删除指定自定义主体，返回任务状态信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
element_id
string
要删除的主体ID，仅支持删除自定义主体。
必选
请求结构
POST /beta/aigc/qianfan-delete-elements HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"element_id": "your_element_id"
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/beta/aigc/qianfan-delete-elements" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"element_id": "your_element_id"
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码，0 表示成功。
可选
message
string
错误信息或状态描述。
可选
request_id
string
请求唯一 ID，用于问题排查。
可选
data
object {2}
任务状态数据。
可选
显示子属性
隐藏子属性
task_id
string
任务 ID。
可选
task_status
string
当前任务状态。可选值：submitted、processing、succeed、failed。
可选
返回示例
{
"code": 0,
"message": "success",
"request_id": "your_request_id",
"data": {
"task_id": "your_task_id",
"task_status": "submitted"
}
}评价此篇文章