删除文件
更新时间：2025-11-21
DELETE
https://qianfan.baidubce.com/v2/files/{file_id}
删除指定文件。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
URL 参数
file_id
string
文件唯一标识符。
必选
请求结构
DELETE /v2/files/{file_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>
示例代码
请求示例
curl -X DELETE https://qianfan.baidubce.com/v2/files/file-abc123 \
-H "Authorization: Bearer bce-v3/ALTAK-*********/614fb**********" 返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
id
string
文件唯一标识符。
可选
object
string
固定值为：file。
可选
deleted
boolean
文件是否成功删除。
可选
JSON
{
"id": "file-abc123",
"object": "file",
"deleted": true
}JSON
{
"error": {
"code": "invalid_delete_file",
"message": "file not found",
"type": "invalid_request_error"
},
"id": "as-*****0qrtx"
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。