Python调用Claude API如何记录request-id并控制重试

云舒

发布时间：2026-11-13 | 9人浏览过

原创

成功读取_request_id，HTTP异常读取状态、request_id与retry-after。本文用完整SDK示例说明单次调用、默认重试与流式和工具任务的完成边界。

Python调用Claude API时，怎样记录request-id并避免重复重试？成功响应可读message._request_id，HTTP错误可从APIStatusError读取request_id、status_code和响应头；连接错误可能没有可用请求ID。官方SDK默认对暂时失败退避重试两次，应用已有统一重试层时，可用max_retries明确配置，避免两层循环叠加。请求失败与外部任务未执行也不是同一个结论。

Claude官方产品封面

先把一次调用记录与业务任务记录分开

API的request-id是定位一次请求的标识。错误JSON也通常含request_id及error对象，type与message说明类别和细节。模型、请求时间及其时区、请求ID、是否获得完整结果，共同帮助定位调用；它们不能代替文件写入或外部工具任务的完成回执。

例如Fable 5.2与Mythos 5.2的事件pgz8r13pk4sm曾有约四分钟overloaded errors，已缓解并标Resolved。恢复说明发表于2026年11月10日21:47 UTC、北京时间11月11日05:47；公告没有精确故障窗口、请求比例、地区或根因，也未说明全部模型和网页都不可用。日志时间相近，不足以把所有失败归为同一事件。

Claude两指定模型历史过载已解决状态

用完整SDK代码记录成功与失败标识

以下示例要求Python已安装官方anthropic SDK，环境变量ANTHROPIC_API_KEY提供自己的密钥，CLAUDE_MODEL提供账户有权访问的真实模型ID。示例不硬编码模型别名或凭据，将SDK重试明确设为0，便于展示单次调用的异常边界：

import logging
import os
import anthropic

logging.basicConfig(level=logging.INFO)
client = anthropic.Anthropic(max_retries=0)
try:
    message = client.messages.create(
        model=os.environ["CLAUDE_MODEL"],
        max_tokens=128,
        messages=[{"role": "user", "content": "用一句话解释Python异常处理"}],
    )
    logging.info("请求完成 request_id=%s", message._request_id)
except anthropic.APIConnectionError:
    logging.exception("连接失败，结果可能尚不确定")
    raise
except anthropic.APIStatusError as error:
    logging.error(
        "HTTP=%s request_id=%s retry_after=%s",
        error.status_code,
        error.request_id,
        error.response.headers.get("retry-after"),
    )
    raise

成功分支记录请求ID，HTTP异常分支保留状态和重试提示，随后重新抛出异常供调用方处理；连接失败不会伪造请求ID。示例没有外层循环，也没有把异常转换成成功返回。日志不输出密钥、Authorization头或完整提示内容，具体模型回答不作为固定预期结果。