文件与批处理

删除 Message Batch

删除已经结束的 Message Batch。

DELETE
/v1/messages/batches/{message_batch_id}

概述

删除已经结束的 Message Batch。删除后,该批次不再出现在列表中,其状态和结果也无法再获取(404)。

说明

  • 只有批次结束、且 TokenLab 已结算其用量之后才能删除。在此之前请求返回 409,错误类型为 conflict_error。仍在处理的批次请先取消,等它结束后再删除。
  • 删除不会改变您已被收取的费用。
  • 删除批次前,请先下载结果。

示例

请求

cURL
curl -X DELETE "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01"

响应示例

响应

200 OK
{
  "id": "msgbatch_01ABC123",
  "type": "message_batch_deleted"
}

重要字段

idstring
已删除批次的 ID。
typestring
始终为 message_batch_deleted。

授权

BearerAuth
AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

路径参数

message_batch_id*string

消息批处理标识符

响应

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json