获取消息批处理结果

get /v1/messages/batches/{message_batch_id}/results

以 .jsonl 文件形式流式传输消息批处理的结果。

文件中的每一行都是一个 JSON 对象，包含消息批处理中单个请求的结果。结果不保证与请求顺序相同。使用 custom_id 字段将结果与请求进行匹配。

在我们的用户指南中了解更多关于消息批处理 API 的信息

路径参数

• message_batch_id: string

  消息批处理的 ID。

请求头参数

• "anthropic-beta": optional array of AnthropicBeta

  可选的请求头，用于指定您要使用的 beta 版本。

  • string

  • "message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 22 more

    • "message-batches-2024-09-24"

    • "prompt-caching-2024-07-31"

    • "computer-use-2024-10-22"

    • "computer-use-2025-01-24"

    • "pdfs-2024-09-25"

    • "token-counting-2024-11-01"

    • "token-efficient-tools-2025-02-19"

    • "output-128k-2025-02-19"

    • "files-api-2025-04-14"

    • "mcp-client-2025-04-04"

    • "mcp-client-2025-11-20"

    • "dev-full-thinking-2025-05-14"

    • "interleaved-thinking-2025-05-14"

    • "code-execution-2025-05-22"

    • "extended-cache-ttl-2025-04-11"

    • "context-1m-2025-08-07"

    • "context-management-2025-06-27"

    • "model-context-window-exceeded-2025-08-26"

    • "skills-2025-10-02"

    • "fast-mode-2026-02-01"

    • "output-300k-2026-03-24"

    • "user-profiles-2026-03-24"

    • "advisor-tool-2026-03-01"

    • "managed-agents-2026-04-01"

    • "cache-diagnosis-2026-04-07"

返回

• BetaMessageBatchIndividualResponse object { custom_id, result }

  这是响应 .jsonl 文件中的单行，并不代表整个响应。

  • custom_id: string

    开发人员为消息批处理中每个请求创建的 ID。用于将结果与请求进行匹配，因为结果可能不按请求顺序返回。

    在消息批处理中，每个请求的此值必须唯一。

  • result: BetaMessageBatchResult

    此请求的处理结果。

    如果处理成功则包含消息输出，如果处理失败则包含错误响应，或者包含未尝试处理的原因（如取消或过期）。

    • BetaMessageBatchSucceededResult object { message, type }

      • message: BetaMessage

        • id: string

          唯一对象标识符。

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

        • container: BetaContainer

          关于请求中使用的容器的信息（用于代码执行工具）

          • id: string

            此请求中使用的容器的标识符

          • expires_at: string

            容器将过期的时间。

          • skills: array of BetaSkill

            容器中加载的技能

            • skill_id: string

              技能 ID

            • type: "anthropic" or "custom"

              技能类型 - 'anthropic'（内置）或 'custom'（用户自定义）

              • "anthropic"

              • "custom"

            • version: string

              技能版本或 'latest' 表示最新版本

        • content: array of BetaContentBlock

          模型生成的内容。

          这是一个内容块数组，每个块都有一个决定其形状的 type。

          Example:

          [{"type": "text", "text": "Hi, I'm Claude."}]
          

          如果请求输入的 messages 以 assistant 轮次结束，则响应 content 将直接从该最后一轮继续。您可以使用此功能来约束模型的输出。

          例如，如果输入 messages 为：

          [
            {"role": "user", "content": "What's the Greek name for Sun? (A) Sol (B) Helios (C) Sun"},
            {"role": "assistant", "content": "The best answer is ("}
          ]
          

          则响应 content 可能为：

          [{"type": "text", "text": "B)"}]
          

          • BetaTextBlock object { citations, text, type }

            • citations: array of BetaTextCitation

              支持文本块的引用。

              返回的引用类型取决于被引用文档的类型。引用 PDF 会返回 page_location，纯文本返回 char_location，内容文档返回 content_block_location。

              • BetaCitationCharLocation object { cited_text, document_index, document_title, 4 more }

                • cited_text: string

                • document_index: number

                • document_title: string

                • end_char_index: number

                • file_id: string

                • start_char_index: number

                • type: "char_location"

                  • "char_location"

              • BetaCitationPageLocation object { cited_text, document_index, document_title, 4 more }

                • cited_text: string

                • document_index: number

                • document_title: string

                • end_page_number: number

                • file_id: string

                • start_page_number: number

                • type: "page_location"

                  • "page_location"

              • BetaCitationContentBlockLocation object { cited_text, document_index, document_title, 4 more }

                • cited_text: string

                  引用块范围的完整文本，已连接。

                  始终等于 content[start_block_index:end_block_index] 连接在一起的内容。文本块是最小可引用单元；此字段永远不会是单个块的子字符串。不计入输出 token，也不计入在后续轮次中发回时的输入 token。

                • document_index: number

                • document_title: string

                • end_block_index: number

                  源 content 数组中引用块范围的排他性从 0 开始的结束索引。

                  始终大于 start_block_index；单块引用的 end_block_index = start_block_index + 1。

                • file_id: string

                • start_block_index: number

                  源 content 数组中第一个引用块的从 0 开始的索引。

                • type: "content_block_location"

                  • "content_block_location"

              • BetaCitationsWebSearchResultLocation object { cited_text, encrypted_index, title, 2 more }

                • cited_text: string

                • encrypted_index: string

                • title: string

                • type: "web_search_result_location"

                  • "web_search_result_location"

                • url: string

              • BetaCitationSearchResultLocation object { cited_text, end_block_index, search_result_index, 4 more }

                • cited_text: string

                  引用块范围的完整文本，已连接。

                  始终等于 content[start_block_index:end_block_index] 连接在一起的内容。文本块是最小可引用单元；此字段永远不会是单个块的子字符串。不计入输出 token，也不计入在后续轮次中发回时的输入 token。

                • end_block_index: number

                  源 content 数组中引用块范围的排他性从 0 开始的结束索引。

                  始终大于 start_block_index；单块引用的 end_block_index = start_block_index + 1。

                • search_result_index: number

                  在请求中所有 search_result 内容块中，被引用搜索结果的从 0 开始的索引，按它们在消息和工具结果中出现的顺序排列。

                  与 document_index 分开计数；服务器端 Web 搜索结果不包含在此计数中。

                • source: string

                • start_block_index: number

                  源 content 数组中第一个引用块的从 0 开始的索引。

                • title: string

                • type: "search_result_location"

                  • "search_result_location"

            • text: string

            • type: "text"

              • "text"

          • BetaThinkingBlock object { signature, thinking, type }

            • signature: string

            • thinking: string

            • type: "thinking"

              • "thinking"

          • BetaRedactedThinkingBlock object { data, type }

            • data: string

            • type: "redacted_thinking"

              • "redacted_thinking"

          • BetaToolUseBlock object { id, input, name, 2 more }

            • id: string

            • input: map[unknown]

            • name: string

            • type: "tool_use"

              • "tool_use"

            • caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120

              模型直接发起的工具调用。

              • BetaDirectCaller object { type }

                模型直接发起的工具调用。

                • type: "direct"

                  • "direct"

              • BetaServerToolCaller object { tool_id, type }

                服务器端工具生成的工具调用。

                • tool_id: string

                • type: "code_execution_20250825"

                  • "code_execution_20250825"

              • BetaServerToolCaller20260120 object { tool_id, type }

                • tool_id: string

                • type: "code_execution_20260120"

                  • "code_execution_20260120"

          • BetaServerToolUseBlock object { id, input, name, 2 more }

            • id: string

            • input: map[unknown]

            • name: "advisor" or "web_search" or "web_fetch" or 5 more

              • "advisor"

              • "web_search"

              • "web_fetch"

              • "code_execution"

              • "bash_code_execution"

              • "text_editor_code_execution"

              • "tool_search_tool_regex"

              • "tool_search_tool_bm25"

            • type: "server_tool_use"

              • "server_tool_use"

            • caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120

              模型直接发起的工具调用。

              • BetaDirectCaller object { type }

                模型直接发起的工具调用。

              • BetaServerToolCaller object { tool_id, type }

                服务器端工具生成的工具调用。

              • BetaServerToolCaller20260120 object { tool_id, type }

          • BetaWebSearchToolResultBlock object { content, tool_use_id, type, caller }

            • content: BetaWebSearchToolResultBlockContent

              • BetaWebSearchToolResultError object { error_code, type }

                • error_code: BetaWebSearchToolResultErrorCode

                  • "invalid_tool_input"

                  • "unavailable"

                  • "max_uses_exceeded"

                  • "too_many_requests"

                  • "query_too_long"

                  • "request_too_large"

                • type: "web_search_tool_result_error"

                  • "web_search_tool_result_error"

              • array of BetaWebSearchResultBlock

                • encrypted_content: string

                • page_age: string

                • title: string

                • type: "web_search_result"

                  • "web_search_result"

                • url: string

            • tool_use_id: string

            • type: "web_search_tool_result"

              • "web_search_tool_result"

            • caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120

              模型直接发起的工具调用。

              • BetaDirectCaller object { type }

                模型直接发起的工具调用。

              • BetaServerToolCaller object { tool_id, type }

                服务器端工具生成的工具调用。

              • BetaServerToolCaller20260120 object { tool_id, type }

          • BetaWebFetchToolResultBlock object { content, tool_use_id, type, caller }

            • content: BetaWebFetchToolResultErrorBlock or BetaWebFetchBlock

              • BetaWebFetchToolResultErrorBlock object { error_code, type }

                • error_code: BetaWebFetchToolResultErrorCode

                  • "invalid_tool_input"

                  • "url_too_long"

                  • "url_not_allowed"

                  • "url_not_accessible"

                  • "unsupported_content_type"

                  • "too_many_requests"

                  • "max_uses_exceeded"

                  • "unavailable"

                • type: "web_fetch_tool_result_error"

                  • "web_fetch_tool_result_error"

              • BetaWebFetchBlock object { content, retrieved_at, type, url }

                • content: BetaDocumentBlock

                  • citations: BetaCitationConfig

                    Citation configuration for the document

                    • enabled: boolean

                  • source: BetaBase64PDFSource or BetaPlainTextSource

                    • BetaBase64PDFSource object { data, media_type, type }

                      • data: string

                      • media_type: "application/pdf"

                        • "application/pdf"

                      • type: "base64"

                        • "base64"

                    • BetaPlainTextSource object { data, media_type, type }

                      • data: string

                      • media_type: "text/plain"

                        • "text/plain"

                      • type: "text"

                        • "text"

                  • title: string

                    文档的标题

                  • type: "document"

                    • "document"

                • retrieved_at: string

                  ISO 8601 timestamp when the content was retrieved

                • type: "web_fetch_result"

                  • "web_fetch_result"

                • url: string

                  Fetched content URL

            • tool_use_id: string

            • type: "web_fetch_tool_result"

              • "web_fetch_tool_result"

            • caller: optional BetaDirectCaller or BetaServerToolCaller or BetaServerToolCaller20260120

              模型直接发起的工具调用。

              • BetaDirectCaller object { type }

                模型直接发起的工具调用。

              • BetaServerToolCaller object { tool_id, type }

                服务器端工具生成的工具调用。

              • BetaServerToolCaller20260120 object { tool_id, type }

          • BetaAdvisorToolResultBlock object { content, tool_use_id, type }

            • content: BetaAdvisorToolResultError or BetaAdvisorResultBlock or BetaAdvisorRedactedResultBlock

              • BetaAdvisorToolResultError object { error_code, type }

                • error_code: "max_uses_exceeded" or "prompt_too_long" or "too_many_requests" or 3 more

                  • "max_uses_exceeded"

                  • "prompt_too_long"

                  • "too_many_requests"

                  • "overloaded"

                  • "unavailable"

                  • "execution_time_exceeded"

                • type: "advisor_tool_result_error"

                  • "advisor_tool_result_error"

              • BetaAdvisorResultBlock object { text, type }

                • text: string

                • type: "advisor_result"

                  • "advisor_result"

              • BetaAdvisorRedactedResultBlock object { encrypted_content, type }

                • encrypted_content: string

                  Opaque blob containing the advisor's output. Round-trip verbatim; do not inspect or modify.

                • type: "advisor_redacted_result"

                  • "advisor_redacted_result"

            • tool_use_id: string

            • type: "advisor_tool_result"

              • "advisor_tool_result"

          • BetaCodeExecutionToolResultBlock object { content, tool_use_id, type }

            • content: BetaCodeExecutionToolResultBlockContent

              代码执行结果，包含用于 PFC + web_search 结果的加密标准输出。

              • BetaCodeExecutionToolResultError object { error_code, type }

                • error_code: BetaCodeExecutionToolResultErrorCode

                  • "invalid_tool_input"

                  • "unavailable"

                  • "too_many_requests"

                  • "execution_time_exceeded"

                • type: "code_execution_tool_result_error"

                  • "code_execution_tool_result_error"

              • BetaCodeExecutionResultBlock object { content, return_code, stderr, 2 more }

                • content: array of BetaCodeExecutionOutputBlock

                  • file_id: string

                  • type: "code_execution_output"

                    • "code_execution_output"

                • return_code: number

                • stderr: string

                • stdout: string

                • type: "code_execution_result"

                  • "code_execution_result"

              • BetaEncryptedCodeExecutionResultBlock object { content, encrypted_stdout, return_code, 2 more }

                代码执行结果，包含用于 PFC + web_search 结果的加密标准输出。

                • content: array of BetaCodeExecutionOutputBlock

                  • file_id: string

                  • type: "code_execution_output"

                • encrypted_stdout: string

                • return_code: number

                • stderr: string

                • type: "encrypted_code_execution_result"

                  • "encrypted_code_execution_result"

            • tool_use_id: string

            • type: "code_execution_tool_result"

              • "code_execution_tool_result"

          • BetaBashCodeExecutionToolResultBlock object { content, tool_use_id, type }

            • content: BetaBashCodeExecutionToolResultError or BetaBashCodeExecutionResultBlock

              • BetaBashCodeExecutionToolResultError object { error_code, type }

                • error_code: "invalid_tool_input" or "unavailable" or "too_many_requests" or 2 more

                  • "invalid_tool_input"

                  • "unavailable"

                  • "too_many_requests"

                  • "execution_time_exceeded"

                  • "output_file_too_large"

                • type: "bash_code_execution_tool_result_error"

                  • "bash_code_execution_tool_result_error"

              • BetaBashCodeExecutionResultBlock object { content, return_code, stderr, 2 more }

                • content: array of BetaBashCodeExecutionOutputBlock

                  • file_id: string

                  • type: "bash_code_execution_output"

                    • "bash_code_execution_output"

                • return_code: number

                • stderr: string

                • stdout: string

                • type: "bash_code_execution_result"

                  • "bash_code_execution_result"

            • tool_use_id: string

            • type: "bash_code_execution_tool_result"

              • "bash_code_execution_tool_result"

          • BetaTextEditorCodeExecutionToolResultBlock object { content, tool_use_id, type }

            • content: BetaTextEditorCodeExecutionToolResultError or BetaTextEditorCodeExecutionViewResultBlock or BetaTextEditorCodeExecutionCreateResultBlock or BetaTextEditorCodeExecutionStrReplaceResultBlock

              • BetaTextEditorCodeExecutionToolResultError object { error_code, error_message, type }

                • error_code: "invalid_tool_input" or "unavailable" or "too_many_requests" or 2 more

                  • "invalid_tool_input"

                  • "unavailable"

                  • "too_many_requests"

                  • "execution_time_exceeded"

                  • "file_not_found"

                • error_message: string

                • type: "text_editor_code_execution_tool_result_error"

                  • "text_editor_code_execution_tool_result_error"

              • BetaTextEditorCodeExecutionViewResultBlock object { content, file_type, num_lines, 3 more }

                • content: string

                • file_type: "text" or "image" or "pdf"

                  • "text"

                  • "image"

                  • "pdf"

                • num_lines: number

                • start_line: number

                • total_lines: number

                • type: "text_editor_code_execution_view_result"

                  • "text_editor_code_execution_view_result"

              • BetaTextEditorCodeExecutionCreateResultBlock object { is_file_update, type }

                • is_file_update: boolean

                • type: "text_editor_code_execution_create_result"

                  • "text_editor_code_execution_create_result"

              • BetaTextEditorCodeExecutionStrReplaceResultBlock object { lines, new_lines, new_start, 3 more }

                • lines: array of string

                • new_lines: number

                • new_start: number

                • old_lines: number

                • old_start: number

                • type: "text_editor_code_execution_str_replace_result"

                  • "text_editor_code_execution_str_replace_result"

            • tool_use_id: string

            • type: "text_editor_code_execution_tool_result"

              • "text_editor_code_execution_tool_result"

          • BetaToolSearchToolResultBlock object { content, tool_use_id, type }

            • content: BetaToolSearchToolResultError or BetaToolSearchToolSearchResultBlock

              • BetaToolSearchToolResultError object { error_code, error_message, type }

                • error_code: "invalid_tool_input" or "unavailable" or "too_many_requests" or "execution_time_exceeded"

                  • "invalid_tool_input"

                  • "unavailable"

                  • "too_many_requests"

                  • "execution_time_exceeded"

                • error_message: string

                • type: "tool_search_tool_result_error"

                  • "tool_search_tool_result_error"

              • BetaToolSearchToolSearchResultBlock object { tool_references, type }

                • tool_references: array of BetaToolReferenceBlock

                  • tool_name: string

                  • type: "tool_reference"

                    • "tool_reference"

                • type: "tool_search_tool_search_result"

                  • "tool_search_tool_search_result"

            • tool_use_id: string

            • type: "tool_search_tool_result"

              • "tool_search_tool_result"

          • BetaMCPToolUseBlock object { id, input, name, 2 more }

            • id: string

            • input: map[unknown]

            • name: string

              MCP 工具的名称

            • server_name: string

              MCP 服务器的名称

            • type: "mcp_tool_use"

              • "mcp_tool_use"

          • BetaMCPToolResultBlock object { content, is_error, tool_use_id, type }

            • content: string or array of BetaTextBlock

              • string

              • BetaMCPToolResultBlockContent = array of BetaTextBlock

                • citations: array of BetaTextCitation

                  支持文本块的引用。

                  返回的引用类型取决于被引用文档的类型。引用 PDF 会返回 page_location，纯文本返回 char_location，内容文档返回 content_block_location。

                • text: string

                • type: "text"

            • is_error: boolean

            • tool_use_id: string

            • type: "mcp_tool_result"

              • "mcp_tool_result"

          • BetaContainerUploadBlock object { file_id, type }

            Response model for a file uploaded to the container.

            • file_id: string

            • type: "container_upload"

              • "container_upload"

          • BetaCompactionBlock object { content, encrypted_content, type }

            A compaction block returned when autocompact is triggered.

            When content is None, it indicates the compaction failed to produce a valid summary (e.g., malformed output from the model). Clients may round-trip compaction blocks with null content; the server treats them as no-ops.

            • content: string

              Summary of compacted content, or null if compaction failed

            • encrypted_content: string

              Opaque metadata from prior compaction, to be round-tripped verbatim

            • type: "compaction"

              • "compaction"

        • context_management: BetaContextManagementResponse

          Context management response.

          Information about context management strategies applied during the request.

          • applied_edits: array of BetaClearToolUses20250919EditResponse or BetaClearThinking20251015EditResponse

            List of context management edits that were applied.

            • BetaClearToolUses20250919EditResponse object { cleared_input_tokens, cleared_tool_uses, type }

              • cleared_input_tokens: number

                Number of input tokens cleared by this edit.

              • cleared_tool_uses: number

                Number of tool uses that were cleared.

              • type: "clear_tool_uses_20250919"

                应用的上下文管理编辑类型。

                • "clear_tool_uses_20250919"

            • BetaClearThinking20251015EditResponse object { cleared_input_tokens, cleared_thinking_turns, type }

              • cleared_input_tokens: number

                Number of input tokens cleared by this edit.

              • cleared_thinking_turns: number

                Number of thinking turns that were cleared.

              • type: "clear_thinking_20251015"

                应用的上下文管理编辑类型。

                • "clear_thinking_20251015"

        • diagnostics: BetaDiagnostics

          Response envelope for request-level diagnostics. Present (possibly null) whenever the caller supplied diagnostics on the request.

          • cache_miss_reason: BetaCacheMissModelChanged or BetaCacheMissSystemChanged or BetaCacheMissToolsChanged or 3 more

            Explains why the prompt cache could not fully reuse the prefix from the request identified by diagnostics.previous_message_id. null means diagnosis is still pending — the response was serialized before the background comparison completed.

            • BetaCacheMissModelChanged object { cache_missed_input_tokens, type }

              • cache_missed_input_tokens: number

                Approximate number of input tokens that would have been read from cache had the prefix matched the previous request.

              • type: "model_changed"

                • "model_changed"

            • BetaCacheMissSystemChanged object { cache_missed_input_tokens, type }

              • cache_missed_input_tokens: number

                Approximate number of input tokens that would have been read from cache had the prefix matched the previous request.

              • type: "system_changed"

                • "system_changed"

            • BetaCacheMissToolsChanged object { cache_missed_input_tokens, type }

              • cache_missed_input_tokens: number

                Approximate number of input tokens that would have been read from cache had the prefix matched the previous request.

              • type: "tools_changed"

                • "tools_changed"

            • BetaCacheMissMessagesChanged object { cache_missed_input_tokens, type }

              • cache_missed_input_tokens: number

                Approximate number of input tokens that would have been read from cache had the prefix matched the previous request.

              • type: "messages_changed"

                • "messages_changed"

            • BetaCacheMissPreviousMessageNotFound object { type }

              • type: "previous_message_not_found"

                • "previous_message_not_found"

            • BetaCacheMissUnavailable object { type }

              • type: "unavailable"

                • "unavailable"

        • model: Model

          将完成您的提示的模型。

          See models for additional details and options.

          • "claude-opus-4-7" or "claude-mythos-preview" or "claude-opus-4-6" or 14 more

            将完成您的提示的模型。

            See models for additional details and options.

            • "claude-opus-4-7"

              Frontier intelligence for long-running agents and coding

            • "claude-mythos-preview"

              New class of intelligence, strongest in coding and cybersecurity

            • "claude-opus-4-6"

              Frontier intelligence for long-running agents and coding

            • "claude-sonnet-4-6"

              Best combination of speed and intelligence

            • "claude-haiku-4-5"

              Fastest model with near-frontier intelligence

            • "claude-haiku-4-5-20251001"

              Fastest model with near-frontier intelligence

            • "claude-opus-4-5"

              Premium model combining maximum intelligence with practical performance

            • "claude-opus-4-5-20251101"

              Premium model combining maximum intelligence with practical performance

            • "claude-sonnet-4-5"

              High-performance model for agents and coding

            • "claude-sonnet-4-5-20250929"

              High-performance model for agents and coding

            • "claude-opus-4-1"

              Exceptional model for specialized complex tasks

            • "claude-opus-4-1-20250805"

              Exceptional model for specialized complex tasks

            • "claude-opus-4-0"

              Powerful model for complex tasks

            • "claude-opus-4-20250514"

              Powerful model for complex tasks

            • "claude-sonnet-4-0"

              High-performance model with extended thinking

            • "claude-sonnet-4-20250514"

              High-performance model with extended thinking

            • "claude-3-haiku-20240307"

              Fast and cost-effective model

          • string

        • role: "assistant"

          Conversational role of the generated message.

          This will always be "assistant".

          • "assistant"

        • stop_details: BetaRefusalStopDetails

          Structured information about a refusal.

          • category: "cyber" or "bio"

            触发拒绝的策略类别。

            null when the refusal doesn't map to a named category.

            • "cyber"

            • "bio"

          • explanation: string

            Human-readable explanation of the refusal.

            This text is not guaranteed to be stable. null when no explanation is available for the category.

          • type: "refusal"

            • "refusal"

        • stop_reason: BetaStopReason

          我们停止的原因。

          可以是以下值之一：

          • "end_turn": the model reached a natural stopping point
          • "max_tokens": we exceeded the requested max_tokens or the model's maximum
          • "stop_sequence": one of your provided custom stop_sequences was generated
          • "tool_use": the model invoked one or more tools
          • "pause_turn": we paused a long-running turn. You may provide the response back as-is in a subsequent request to let the model continue.
          • "refusal": when streaming classifiers intervene to handle potential policy violations

          In non-streaming mode this value is always non-null. In streaming mode, it is null in the message_start event and non-null otherwise.

          • "end_turn"

          • "max_tokens"

          • "stop_sequence"

          • "tool_use"

          • "pause_turn"

          • "compaction"

          • "refusal"

          • "model_context_window_exceeded"

        • stop_sequence: string

          Which custom stop sequence was generated, if any.

          This value will be a non-null string if one of your custom stop sequences was generated.

        • type: "message"

          对象类型。

          For Messages, this is always "message".

          • "message"

        • usage: BetaUsage

          Billing and rate-limit usage.

          Anthropic's API bills and rate-limits by token counts, as tokens represent the underlying cost to our systems.

          Under the hood, the API transforms requests into a format suitable for the model. The model's output then goes through a parsing stage before becoming an API response. As a result, the token counts in usage will not match one-to-one with the exact visible content of an API request or response.

          For example, output_tokens will be non-zero, even for an empty string response from Claude.

          Total input tokens in a request is the summation of input_tokens, cache_creation_input_tokens, and cache_read_input_tokens.

          • cache_creation: BetaCacheCreation

            Breakdown of cached tokens by TTL

            • ephemeral_1h_input_tokens: number

              用于创建 1 小时缓存条目的输入 token 数。

            • ephemeral_5m_input_tokens: number

              用于创建 5 分钟缓存条目的输入 token 数。

          • cache_creation_input_tokens: number

            用于创建缓存条目的输入 token 数。

          • cache_read_input_tokens: number

            从缓存读取的输入 token 数。

          • inference_geo: string

            此请求执行推理的地理区域。

          • input_tokens: number

            已使用的输入 token 数。

          • iterations: BetaIterationsUsage

            Per-iteration token usage breakdown.

            Each entry represents one sampling iteration, with its own input/output token counts and cache statistics. This allows you to:

            • Determine which iterations exceeded long context thresholds (>=200k tokens)

            • Calculate the true context window size from the last iteration

            • Understand token accumulation across server-side tool use loops

            • BetaMessageIterationUsage object { cache_creation, cache_creation_input_tokens, cache_read_input_tokens, 3 more }

              Token usage for a sampling iteration.

              • cache_creation: BetaCacheCreation

                Breakdown of cached tokens by TTL

              • cache_creation_input_tokens: number

                用于创建缓存条目的输入 token 数。

              • cache_read_input_tokens: number

                从缓存读取的输入 token 数。

              • input_tokens: number

                已使用的输入 token 数。

              • output_tokens: number

                已使用的输出 token 数。

              • type: "message"

                Usage for a sampling iteration

                • "message"

            • BetaCompactionIterationUsage object { cache_creation, cache_creation_input_tokens, cache_read_input_tokens, 3 more }

              Token usage for a compaction iteration.

              • cache_creation: BetaCacheCreation

                Breakdown of cached tokens by TTL

              • cache_creation_input_tokens: number

                用于创建缓存条目的输入 token 数。

              • cache_read_input_tokens: number

                从缓存读取的输入 token 数。

              • input_tokens: number

                已使用的输入 token 数。

              • output_tokens: number

                已使用的输出 token 数。

              • type: "compaction"

                Usage for a compaction iteration

                • "compaction"

            • BetaAdvisorMessageIterationUsage object { cache_creation, cache_creation_input_tokens, cache_read_input_tokens, 4 more }

              Token usage for an advisor sub-inference iteration.

              • cache_creation: BetaCacheCreation

                Breakdown of cached tokens by TTL

              • cache_creation_input_tokens: number

                用于创建缓存条目的输入 token 数。

              • cache_read_input_tokens: number

                从缓存读取的输入 token 数。

              • input_tokens: number

                已使用的输入 token 数。

              • model: Model

                将完成您的提示的模型。

                See models for additional details and options.

              • output_tokens: number

                已使用的输出 token 数。

              • type: "advisor_message"

                Usage for an advisor sub-inference iteration

                • "advisor_message"

          • output_tokens: number

            已使用的输出 token 数。

          • server_tool_use: BetaServerToolUsage

            服务器工具请求数。

            • web_fetch_requests: number

              网络获取工具请求数。

            • web_search_requests: number

              网络搜索工具请求数。

          • service_tier: "standard" or "priority" or "batch"

            If the request used the priority, standard, or batch tier.

            • "standard"

            • "priority"

            • "batch"

          • speed: "standard" or "fast"

            此请求使用的推理速度模式。

            • "standard"

            • "fast"

      • type: "succeeded"

        • "succeeded"

    • BetaMessageBatchErroredResult object { error, type }

      • error: BetaErrorResponse

        • error: BetaError

          • BetaInvalidRequestError object { message, type }

            • message: string

            • type: "invalid_request_error"

              • "invalid_request_error"

          • BetaAuthenticationError object { message, type }

            • message: string

            • type: "authentication_error"

              • "authentication_error"

          • BetaBillingError object { message, type }

            • message: string

            • type: "billing_error"

              • "billing_error"

          • BetaPermissionError object { message, type }

            • message: string

            • type: "permission_error"

              • "permission_error"

          • BetaNotFoundError object { message, type }

            • message: string

            • type: "not_found_error"

              • "not_found_error"

          • BetaRateLimitError object { message, type }

            • message: string

            • type: "rate_limit_error"

              • "rate_limit_error"

          • BetaGatewayTimeoutError object { message, type }

            • message: string

            • type: "timeout_error"

              • "timeout_error"

          • BetaAPIError object { message, type }

            • message: string

            • type: "api_error"

              • "api_error"

          • BetaOverloadedError object { message, type }

            • message: string

            • type: "overloaded_error"

              • "overloaded_error"

        • request_id: string

        • type: "error"

          • "error"

      • type: "errored"

        • "errored"

    • BetaMessageBatchCanceledResult object { type }

      • type: "canceled"

        • "canceled"

    • BetaMessageBatchExpiredResult object { type }

      • type: "expired"

        • "expired"

示例

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