Anthropic Base URL 是否包含 /v1？
SDK 的 base_url 使用站点根域名；直接 HTTP 请求的路径为 /v1/messages。
Anthropic Messages API 请求
curl https://claudeagent.com.cn/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "COPY_FROM_V1_MODELS",
"max_tokens": 256,
"messages": [{"role": "user", "content": "Reply with OK"}]
}'Anthropic 兼容入口使用站点根域名加 /v1/messages。模型名必须从当前 Key 可见的 /v1/models 返回中复制。
Anthropic Python SDK
from anthropic import Anthropic
client = Anthropic(
api_key="YOUR_API_KEY",
base_url="https://claudeagent.com.cn",
)
message = client.messages.create(
model="COPY_FROM_V1_MODELS",
max_tokens=256,
messages=[{"role": "user", "content": "Reply with OK"}],
)
print(message.content[0].text)如果 SDK 版本不接受自定义 base_url，先升级 SDK；不要通过关闭 TLS 校验绕过证书错误。
字段、流式与工具调用
| 能力 | 请求方式 | 接入提示 |
|---|---|---|
| System prompt | 顶层 system 字段 | 不要伪装成 user 消息 |
| 流式响应 | stream: true | 按 SSE 事件读取，设置合理读取超时 |
| 工具调用 | tools 与 tool_choice | 先用短请求确认当前模型和分组支持 |
| 图片输入 | content 中的 image 块 | 使用前核对模型能力和分组说明 |
| 用量 | response.usage | 分别记录输入、输出和缓存字段 |
这是 Anthropic API 兼容网关，不代表所有模型、beta header 或实验字段在每个分组都完全相同。生产接入前应固定模型和请求样本进行验收。
常见问题
可以直接使用官方 Anthropic Key 吗？
不可以。本站兼容入口使用 Claude Agent 控制台创建的 API Key。