删除前缀缓存
更新时间:2025-11-07
DELETE
https://qianfan.baidubce.com/v2/caching/{cache_id}
删除上下文缓存
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权
请求参数
Headers 参数
除公共头域外,无其它特殊头域
URL 参数
cache_id
string
此次请求删除的缓存id。
必选
请求结构
DELETE /v2/caching/{cache_id} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
示例代码
请求示例
curl -X DELETE 'https://qianfan.baidubce.com/v2/caching/{cache_id}' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--header 'Content-Type: application/json' \
返回响应
Headers 参数
除公共头域外,无其它特殊头域
返回参数
id
string
需要删除的缓存id。
必选
deleted
boolean
true:缓存已成功删除
false:缓存未删除
必选
JSON
{
"id": "cache-20251106141838-xxxx",
"model": "deepseek-v3.1-think-250821",
"mode": "common_prefix",
"ttl": 3600,
"usage": {
"prompt_tokens": 70,
"completion_tokens": 0,
"total_tokens": 70
},
"expire_at": 1762413518
}
JSON
{
"error": {
"code": "invalid_id",
"message": "id cache-20251106144603-dtu277kw3f not found",
"type": "invalid_request_error"
},
"id": "as-hpz2h7gicu"
}
错误码
如果请求错误,服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息,帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码,请查看模型错误码说明。
