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 연동을 참고하세요.