Messages(Anthropic 호환)
POST /v1/messages·POST /v1/messages/count_tokensClaude 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 연동을 참고하세요.