Anthropic API 是 Anthropic 提供的模型接口,用来调用 Claude 系列模型。很多人会把“Anthropic API”“Claude API”“Claude Code”混在一起,其实它们是不同层面的东西。
本文讲清楚 Anthropic API 是什么、怎么调用、和 OpenAI 协议有什么区别,以及国内接入的两种方式。
说明:Anthropic、Claude 是其权利人的商标。本文以 2026 年 10 月的常见版本为例,接口和价格以官方/站内为准。
一、三个概念的关系
- Anthropic:开发 Claude 模型的公司。
- Anthropic API / Claude API:调用 Claude 模型的接口,通常指 Messages API。
- Claude Code:Anthropic 的命令行编程工具,内部通过 API 调用模型。
所以你会在不同文档里看到“Anthropic API”和“Claude API”混用,大多数时候指的是同一个模型接口。
二、Anthropic API 的特点
1. Messages API
核心接口是 POST /v1/messages,请求体包含:
modelmax_tokensmessagessystem(可选)temperature、top_p等(可选)tools(可选)
2. 请求头
原生接口通常需要:
x-api-key: sk-...
anthropic-version: 2023-06-01
content-type: application/json
不同版本/网关可能支持 Bearer Token,具体以文档为准。
3. 模型分档
Claude 常见分档:
| 档位 | 适合场景 |
|---|---|
| Opus | 复杂推理、长链路 Agent、难题 |
| Sonnet | 日常写代码、改 Bug、代码审查 |
| Haiku | 简单任务、批量处理、低成本 |
具体模型名和价格以 模型价格 为准。
三、直接调用示例
export ANTHROPIC_API_KEY="sk-你的密钥"
curl "https://api.anthropic.com/v1/messages" \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 256,
"messages": [
{"role": "user", "content": "用三句话解释 Messages API"}
]
}'
如果你用 SDK,按 Anthropic 官方 SDK 的方式初始化,不要套用 OpenAI SDK 的请求格式。
四、Anthropic API 和 OpenAI API 的区别
| 维度 | Anthropic API | OpenAI API |
|---|---|---|
| 核心路径 | /v1/messages | /v1/chat/completions |
| 认证头 | x-api-key | Authorization: Bearer |
| 版本头 | anthropic-version | 无 |
| 消息格式 | messages + system | messages(含 system role) |
| 工具调用 | tools | tools / functions |
| SDK | Anthropic SDK | OpenAI SDK |
两者不是直接兼容的。很多网关会同时提供两种入口:Anthropic 兼容给 Claude Code,OpenAI 兼容给 OpenAI SDK/工具。
五、国内接入的两种方式
方式 A:官方直连
Base URL:https://api.anthropic.com
适合能稳定访问 Anthropic、已有官方账号和付款方式的团队。
方式 B:中商起航网关
- Anthropic 兼容入口:
https://ai.zhongshangqihang.com(用于 Claude Code 等) - OpenAI 兼容入口:
https://ai.zhongshangqihang.com/v1(用于 OpenAI SDK/工具)
在 中商起航 AI 网关 注册、创建 Key、充值后即可使用。模型名以 模型价格 为准。
六、用 OpenAI SDK 调 Claude
如果你的工具只支持 OpenAI 协议,可以用网关的 OpenAI 兼容入口:
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://ai.zhongshangqihang.com/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-5",
messages=[{"role": "user", "content": "只回复 OK"}],
)
print(resp.choices[0].message.content)
注意:这不是 Anthropic 原生协议,参数和能力可能有差异。需要原生工具调用/缓存时,优先用 Anthropic 兼容入口。
七、计费怎么理解
Anthropic API 通常按输入 Token、输出 Token、缓存等计费。注意:
- 输出 Token 通常比输入贵。
- 长上下文会放大输入 Token。
- 缓存命中可以省钱,但不是所有请求都命中。
- 不同档位(Opus/Sonnet/Haiku)单价差异大。
具体单价以 模型价格 为准。估算方法看 Claude Code 价格:订阅 vs API。
八、常见问题
Anthropic API 和 Claude API 是同一个吗?
大多数语境下是同一个模型接口,只是叫法不同。
Anthropic API 支持 OpenAI 格式吗?
原生不支持。需要通过网关的 OpenAI 兼容入口,或使用适配层。
国内怎么稳定调用?
可以使用官方直连(如果网络允许),或使用国内可访问的网关。注意数据合规和服务条款。
Claude Code 用的是哪个接口?
Claude Code 走 Anthropic Messages API,具体配置看 Claude Code API 完整教程。
下一步
如果你需要国内稳定访问、统一账单或多模型切换,可以先 注册中商起航 AI 网关,创建测试 Key,跑通一条 Messages 请求。模型和价格以 模型价格 为准。
相关阅读:
