Anthropic Messages

POST https://api.nexuskey.cn/v1/messages

Anthropic Messages 原生协议。OpenAI 系模型经此端点时走 chat fallback 桥接。

请求头

头	必填	说明
x-api-key	是（或与 Bearer 二选一）	sk-…
anthropic-version	是	2023-06-01
content-type	是	application/json

请求参数

参数	类型	必填	说明
model	string	是	如 claude-sonnet-4-5
max_tokens	integer	是	输出上限
messages	array	是	user / assistant 消息（含 tool_result/tool_use 块）
system	string/array	否	系统提示（支持缓存控制块）
stream	boolean	否	SSE 流式
temperature / top_p / top_k	number	否	采样参数
tools / tool_choice	array/object	否	工具定义与策略
thinking	object	否	扩展思考配置（按模型支持度）
metadata	object	否	用户标识等元数据

示例

Python

from anthropic import Anthropic

client = Anthropic(base_url="https://api.nexuskey.cn", api_key="<你的 NEXUSKEY_API_KEY>")
message = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    system="你是一个简洁的助手",
    messages=[{"role": "user", "content": "什么是提示缓存？"}],
)
print(message.content[0].text)
print(message.usage)

cURL

curl https://api.nexuskey.cn/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $NEXUSKEY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "什么是提示缓存？"}]
  }'

响应

Anthropic 原生结构：content[]（text/tool_use/thinking 块）、stop_reason、usage。

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-5",
  "content": [{ "type": "text", "text": "…" }],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 32,
    "cache_read_input_tokens": 0,
    "cache_creation_input_tokens": 0,
    "output_tokens": 128
  }
}

usage 口径

Anthropic 的 input_tokens 不含缓存：总输入 = input_tokens + cache_read_input_tokens + cache_creation_input_tokens。计费按归一后的总输入分类计价，见 计费与套餐。

POST /v1/messages/count_tokens

请求体同 messages（不含 max_tokens），返回 {"input_tokens": N}。OpenAI 系模型走桥接估算，结果可能与原生计数略有差异。

流式与错误

命名事件 SSE（message_start / content_block_delta / message_delta / ping 等），详见 流式（SSE）；错误体为 Anthropic 风格 {"type":"error","error":{"type":"…","message":"…"}}，矩阵见 错误码。