首批通过分布式安全可靠测评，为关键业务系统打造
Delete file - 删除 Batch 文件
更新时间：2026-06-11 12:55:10
分享
功能说明
删除指定的 Batch 文件。成功删除后，返回的文件对象中将包含 deleted=true 标识。当前仅支持阿里云 qwen 系列模型。
调用说明
接口约束
- 调用者需要拥有 API Key，详情请参见 管理 AI API Key。
请求路径
DELETE {BASE_URL}/api/v1/files/{file_id}
请求头
| 名称 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|
| Authorization | 是 | Bearer {token} | 鉴权信息 |
| Content-Type | 否 | application/json | 请求体格式 |
请求参数
Path 参数
| 名称 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
| file_id | string | 是 | file-abc123 | 需要删除的 Batch 文件 ID |
Query 参数
无
Body 参数
无
返回结果
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| success | boolean | 请求是否成功 |
| code | string | 返回码 |
| message | string | 返回信息 |
| data | object | 业务返回数据 |
data 字段说明
返回被删除的文件对象，其具体字段结构未知。
请求示例
curl --request DELETE '{BASE_URL}/api/v1/files/file-abc123' \
--header 'Authorization: Bearer {token}'
返回示例
成功响应 (200)
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"id": "file-abc123",
"object": "file",
"deleted": true
}
}
未鉴权响应 (401)
{
"success": false,
"code": "401",
"message": "Unauthorized"
}
文件不存在响应 (404)
{
"success": false,
"code": "404",
"message": "File not found"
}
