Anthropic SDK

先在统一配置引导中选择模型和协议，再选择或创建匹配密钥。引导会提供可复制配置和填写说明。

安装

python -m pip install anthropic

准备环境变量

按快速开始设置 TODOOAI_API_KEY，并将 TODOOAI_MODEL 设置为支持 Anthropic Messages 的完整模型 ID。

发送 Messages 请求

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["TODOOAI_API_KEY"],
    base_url="https://toodooai.com",
    timeout=60.0,
    max_retries=0,
)

message = client.messages.create(
    model=os.environ["TODOOAI_MODEL"],
    max_tokens=256,
    messages=[{"role": "user", "content": "请用一句话介绍你自己。"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

SDK 会补充 Messages 请求路径；Base URL 使用根地址，避免重复拼接 /v1。Anthropic 官方 Python SDK

验证兼容范围

模型必须支持该协议。图片、工具调用、缓存和思考等扩展能力取决于实际模型与渠道配置，应在基础对话通过后分别验证。

失败时保留状态码及脱敏错误信息，参考错误码与排障。

运行前检查

先用当前密钥查询可用模型，再将一个明确支持 Anthropic Messages 的完整模型 ID写入 TODOOAI_MODEL。OpenAI Chat Completions 能够成功，不代表该模型同时支持 Messages；协议能力必须单独确认。

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["TODOOAI_API_KEY"],
    base_url="https://toodooai.com",
)

print(client.models.list())

从基础请求逐项增加能力

先保持 max_tokens 较小并发送一条文本消息，再依次验证流式输出、图片、工具调用、缓存和思考等扩展。每次只增加一项，发生 400 时可以快速定位是消息格式还是新参数不兼容。

Anthropic SDK 的 base_url 使用根地址 https://toodooai.com，不要填入 /v1/messages。如果报 404，先检查是否误用了 OpenAI 兼容 Base URL；如果报 401，检查 API Key 是否被当前进程读取。

服务端安全

Anthropic SDK 应运行在服务端或受控脚本中。不要将 TODOOAI_API_KEY 打包进浏览器前端，也不要把完整异常对象、请求头和密钥一起写入日志。需要提交问题时，只保留时间、状态码、模型 ID和脱敏后的错误。