NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

Messages(Anthropic 互換)

POST /v1/messages · POST /v1/messages/count_tokens Claude 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 導入 を参照してください。