Anthropic Python SDK 接入图灵 API

基础调用 最小示例

1. 初始化 Anthropic 客户端
2. base_url 填域名，不带 /v1
3. 调用 messages.create，别忘了 max_tokens

from anthropic import Anthropic
import os

client = Anthropic(
    base_url="https://turingapi.space",
    api_key=os.environ["TURING_API_KEY"],
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)

max_tokens 是这个 SDK 的必填参数，漏掉会直接抛参数错误，很多人第一次用都会卡在这。

流式输出 常用写法

1. 用 client.messages.stream 上下文管理器
2. 注册 text_stream 逐段取文本
3. 结束时可以取完整消息对象

with client.messages.stream(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一段快排"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

用 text_stream 比自己解析事件更省事，它已经把文本增量拼好了。

两种 SDK 混用 进阶

1. 同一把密钥既能调 /v1/messages 也能调 /v1/chat/completions
2. OpenAI SDK 也能调 Claude 模型，只是走 Chat Completions 协议
3. 要原生 Messages 特性（如特定的 system 字段行为）就用这个 SDK

选哪个 SDK 取决于你想用哪套协议，不取决于模型属于哪家厂商。

看到这些就说明通了

1. 返回 msg.content[0].text 且是正常中文回答
2. 没有抛 AuthenticationError
3. 控制台「用量」页出现这次调用

能拿到 content 数组里的文本，说明 Messages 协议这条路是通的。

404 的定位方法

1. 先看 base_url 是否多写了 /v1
2. 再看模型名是否存在
3. 最后确认密钥没有多余空格

print(client.base_url)

打印出来如果结尾是 /v1，去掉它再试，这是最高频的错误。