NNexithDocs
状态控制台 ↗
概览与快速开始模型目录指南API 参考集成OAuth2 / OIDC

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 接入。