获取消息批处理

get /v1/messages/batches/{message_batch_id}

此端点是幂等的，可用于轮询消息批处理的完成状态。要访问消息批处理的结果，请向响应中的 results_url 字段发出请求。

在我们的用户指南中了解更多关于 Message Batches API 的信息

路径参数

• message_batch_id: string

  消息批处理的 ID。

返回值

• MessageBatch object { id, archived_at, cancel_initiated_at, 7 more }

  • id: string

    唯一对象标识符。

    ID 的格式和长度可能会随时间变化。

  • archived_at: string

    RFC 3339 日期时间字符串，表示消息批处理被归档且其结果变为不可用的时间。

  • cancel_initiated_at: string

    RFC 3339 日期时间字符串，表示为消息批处理启动取消的时间。仅在启动取消时指定。

  • created_at: string

    RFC 3339 日期时间字符串，表示消息批处理创建的时间。

  • ended_at: string

    RFC 3339 日期时间字符串，表示消息批处理处理结束的时间。仅在处理结束后指定。

    当消息批处理中的每个请求已成功、出错、取消或过期时，处理结束。

  • expires_at: string

    RFC 3339 日期时间字符串，表示消息批处理将过期并结束处理的时间，即创建后 24 小时。

  • processing_status: "in_progress" or "canceling" or "ended"

    消息批处理的处理状态。

    • "in_progress"

    • "canceling"

    • "ended"

  • request_counts: MessageBatchRequestCounts

    按状态分类统计消息批处理中的请求。

    请求从 processing 开始，只有在整个批处理处理结束后才会转移到其他状态。所有值的总和始终与批处理中的请求总数匹配。

    • canceled: number

      消息批处理中已取消的请求数。

      在整个消息批处理处理结束之前，此值为零。

    • errored: number

      消息批处理中遇到错误的请求数。

      在整个消息批处理处理结束之前，此值为零。

    • expired: number

      消息批处理中已过期的请求数。

      在整个消息批处理处理结束之前，此值为零。

    • processing: number

      消息批处理中正在处理的请求数。

    • succeeded: number

      消息批处理中已成功完成的请求数。

      在整个消息批处理处理结束之前，此值为零。

  • results_url: string

    包含消息批处理请求结果的 .jsonl 文件的 URL。仅在处理结束后指定。

    文件中的结果不保证与请求的顺序相同。使用 custom_id 字段将结果与请求进行匹配。

  • type: "message_batch"

    对象类型。

    对于消息批处理，始终为 "message_batch"。

    • "message_batch"

示例

curl https://api.anthropic.com/v1/messages/batches/$MESSAGE_BATCH_ID \
    -H 'anthropic-version: 2023-06-01' \
    -H "X-Api-Key: $ANTHROPIC_API_KEY"

响应

{
  "id": "msgbatch_013Zva2CMHLNnXjNJJKqJ2EF",
  "archived_at": "2024-08-20T18:37:24.100435Z",
  "cancel_initiated_at": "2024-08-20T18:37:24.100435Z",
  "created_at": "2024-08-20T18:37:24.100435Z",
  "ended_at": "2024-08-20T18:37:24.100435Z",
  "expires_at": "2024-08-20T18:37:24.100435Z",
  "processing_status": "in_progress",
  "request_counts": {
    "canceled": 10,
    "errored": 30,
    "expired": 10,
    "processing": 100,
    "succeeded": 50
  },
  "results_url": "https://api.anthropic.com/v1/messages/batches/msgbatch_013Zva2CMHLNnXjNJJKqJ2EF/results",
  "type": "message_batch"
}