Anthropic Messages 接入与 SDK

NAAPI 提供的 Anthropic Messages 兼容接口，适合 Claude 原生 SDK、content blocks、prompt caching、thinking 和 Anthropic 工具调用协议。

LLM 必读

API 主机：https://naapi.cc

完整接口：POST https://naapi.cc/v1/messages

推荐鉴权：x-api-key: <API_KEY>

必填版本头：anthropic-version: 2023-06-01

也支持：Authorization: Bearer <API_KEY>

必填请求字段：model、messages、max_tokens

非流式文本：遍历 content[] 中 type == "text" 的 text

API Key 建议从 NAAPI_API_KEY 环境变量读取

naapi.apifox.cn 是文档站点。Anthropic SDK 的 base_url 应设为 https://naapi.cc。

适用场景

已经使用 client.messages.create(...) 的 Claude 项目

需要 Anthropic tool_use / tool_result 协议

需要 thinking、prompt caching 或 Anthropic 原生 usage 字段

需要最小化 OpenAI 与 Anthropic 协议转换差异

最小 curl 请求

将 MODEL 替换为账户当前可用的 Anthropic Messages 兼容模型 ID。

Bearer 鉴权

原生 Anthropic SDK 推荐使用 x-api-key。自定义 HTTP 客户端也可以使用 Authorization: Bearer <API_KEY>，但仍需发送 anthropic-version。

核心字段

字段	必填	说明
`model`	是	模型 ID
`messages`	是	Anthropic `user` / `assistant` 消息数组
`max_tokens`	是	最大输出 Token 数，必须大于 0
`system`	否	顶层系统指令，字符串或 content blocks
`stream`	否	`true` 启用 Anthropic SSE 事件流
`temperature`	否	采样温度，范围通常为 0-1
`stop_sequences`	否	停止序列数组
`tools`	否	Anthropic 工具定义，使用 `input_schema`
`tool_choice`	否	`auto`、`any`、`tool` 或 `none`
`thinking`	否	支持的模型可配置 `budget_tokens`

system 不是 messages 中的 system role。Anthropic 原生协议应将系统指令放在顶层 system。

Python 官方 SDK

Python 流式输出

JavaScript 官方 SDK

工具调用要点

模型发出的工具块类型为 tool_use

客户端执行工具后，通过新的 user 消息回传 tool_result

tool_result.tool_use_id 必须匹配模型返回的 tool_use.id

工具输入 Schema 字段名为 input_schema，不是 OpenAI 的 parameters

Prompt caching 与 usage

Anthropic 响应可能包含 input_tokens、cache_creation_input_tokens、cache_read_input_tokens 和 output_tokens。不要仅用 input_tokens 推断全部输入规模或费用。

LLM / Agent 执行规则

必须发送 anthropic-version: 2023-06-01。

必须显式传入大于 0 的 max_tokens。

系统指令放在顶层 system，不要创建 Anthropic 不支持的 system role 消息。

不要把 OpenAI 的 tool_calls、tool_call_id 或 response_format 直接发到此接口。

文本不一定在 content[0]；应遍历 content blocks 并按 type 处理。

不要假定所有模型都支持 thinking、speed、MCP 或所有扩展字段。

API Key 只从环境变量或密钥管理服务读取。

失败时读取 error.message；400 / 401 / 429 不要盲目重试。

常见错误

状态	常见原因	处理
`400`	缺少 `max_tokens`、content block 错误或字段不兼容	读取 `error.message` 并修正请求
`401`	`x-api-key` / Bearer Key 缺失或无效	检查鉴权请求头
`429`	频率、并发或额度限制	降低并发，使用退避
`5xx`	网关或上游短暂异常	有上限地重试，避免重复执行工具

Anthropic Messages

Anthropic Messages 接入与 SDK#

LLM 必读#

适用场景#

最小 curl 请求#

Bearer 鉴权#

核心字段#

Python 官方 SDK#

Python 流式输出#

JavaScript 官方 SDK#

工具调用要点#

Prompt caching 与 usage#

LLM / Agent 执行规则#

常见错误#