开始使用 ↗

接入指南

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。

继续探索