接入指南
Anthropic Python SDK 与 Claude 接入指南
使用 Anthropic Python SDK 调用 Claude:将客户端连接到 ZHUAN 的 /proxy 地址,使用本站 API Key,并按 Messages 格式组织请求。
安装与接口地址
先准备已开通的 ZHUAN API Key,并设置 ZHUAN_API_KEY 环境变量。SDK 的 base_url 为 https://key.zhuan.xyz/proxy;SDK 会追加 /v1/messages,不要在 base_url 中重复填写完整接口路径。
python -m pip install anthropic
最小 Messages 请求
max_tokens 用于限制本次最大输出,messages 包含用户消息。示例使用 claude-sonnet-4-6;请先确认目录中仍有该模型,并查看当前价格。
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["ZHUAN_API_KEY"],
base_url="https://key.zhuan.xyz/proxy",
timeout=60.0,
max_retries=0,
)
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=128,
messages=[{"role": "user", "content": "Hello"}],
)
for block in message.content:
if block.type == "text":
print(block.text)
流式 Messages
沿用上面的 client,通过 messages.stream 的上下文管理器读取 text_stream。只需要处理文本时可以使用下面的写法;工具调用需要另外处理结构化内容块。
with client.messages.stream(
model="claude-sonnet-4-6",
max_tokens=128,
messages=[{"role": "user", "content": "Hello"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
兼容性和排查
- 系统提示、缓存、工具和多模态参数需按当前接口验证。涉及严格指令遵循的业务,应使用自己的测试集检查实际响应。
- 若遇到 401,检查本站 Key 和 x-api-key;429 时降低并发并按服务响应退避。不要把 OpenAI 格式和 Messages 格式的字段直接混用。
- 调用成功后,在控制台核对模型、Token 和费用;排查时保留请求 ID,不记录完整 Key。