Messages(Anthropic 兼容)
POST /v1/messages·POST /v1/messages/count_tokens供 Claude Code 等 Anthropic 客户端把 Nexith 当作上游使用
网关在协议边界做双向翻译,内部仍走同一条 Chat 执行管道(路由、计费、护栏、缓存 全部复用)。对外表现为标准 Anthropic Messages API。
认证#
支持两种 Header:
x-api-key: nx-...
anthropic-version: 2023-06-01或
Authorization: Bearer nx-...POST /v1/messages#
Body#
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | ✅ | nexith-core |
messages |
array | ✅ | {role: "user"|"assistant", content} |
system |
string | blocks | — | 顶层 system,翻译为第一条 system 消息 |
max_tokens |
integer | — | 缺失则不设上限(交给上游默认) |
stream |
bool | — | 默认 false |
temperature |
number | — | |
top_p |
number | — | |
tools |
array | — | {name, description, input_schema} |
tool_choice |
object | — | Anthropic 形状,翻译为 OpenAI tool_choice |
content 可以是字符串,也可以是 content block 数组(text、image、tool_use、
tool_result)。
响应#
{
"id": "msg_chatcmpl-ab64f280-…",
"type": "message",
"role": "assistant",
"model": "nexith-core",
"content": [{"type": "text", "text": "ok"}],
"stop_reason": "end_turn",
"stop_sequence": null,
"usage": {"input_tokens": 320, "output_tokens": 2}
}工具调用返回 content 中的 tool_use block。
流式#
stream=true 时按 Anthropic SSE 事件返回,事件顺序与官方一致:
event: message_start
event: content_block_start
event: content_block_delta
event: content_block_stop
event: message_delta
event: message_stop实测样例:
event: content_block_delta
data: {"delta":{"text":"ok","type":"text_delta"},"index":0,"type":"content_block_delta"}POST /v1/messages/count_tokens#
对同一份 messages / system / tools 估算输入 token,返回:
{"input_tokens": 320}用于 Claude Code 的上下文预算显示;估算口径与计费一致(字符数近似),不保证与 上游 tokenizer 完全相等。
客户端配置(Claude Code)#
export ANTHROPIC_BASE_URL=https://api.nexith.ai
export ANTHROPIC_AUTH_TOKEN=nx-...
export ANTHROPIC_MODEL=nexith-core详见 Claude Code 接入。