Messages(Anthropic 互換)
POST /v1/messages·POST /v1/messages/count_tokensClaude Code などの Anthropic クライアントが Nexith をアップストリームとして利用するためのものです
ゲートウェイはプロトコル境界で双方向の翻訳を行い、内部では同じ Chat 実行パイプラインを通過します(ルーティング、課金、ガードレール、キャッシュ はすべて再利用)。外部からは標準の Anthropic Messages API として振る舞います。
認証#
2 種類の 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 導入 を参照してください。