← 문서 목록

POST /v1/messages

Anthropic Messages 호환 엔드포인트와 무과금 토큰 카운트.

Anthropic Messages 호환 — Claude Code 등 anthropic-native 클라이언트가 그대로 붙습니다. 내부적으로 동일한 채팅 파이프라인을 타며 stream 을 지원합니다.

Parameters

ParameterTypeRequiredDescription
modelstringYes모델 ID
messagesarrayYesroleuser / assistant. content 는 문자열 또는 블록 배열(text·image·tool_use·tool_result·thinking·document)
max_tokensintegerYes1~200000 (Anthropic 규격상 필수)
systemstring | arrayNo문자열 또는 text 블록 배열
temperaturenumberNo0~1
top_pnumberNo0~1
top_kintegerNo양의 정수
stop_sequencesstring[]No최대 8개
streambooleanNo기본 false
toolsarrayNo{name, description, input_schema}
tool_choiceobjectNo{"type":"auto"|"any"|"none"} 또는 {"type":"tool","name":"..."}
metadataobjectNo{"user_id": "..."}
thinkingobjectNo{"type":"enabled","budget_tokens":N} (N < max_tokens) · {"type":"adaptive"} · {"type":"disabled"}
everyaisobjectNo게이트웨이 캐싱 옵션

블록에 cache_control 을 직접 붙이면 그대로 전달됩니다(프롬프트 캐싱 참고).

Request

{
  "model": "everyais/claude-opus-5",
  "max_tokens": 1024,
  "messages": [{"role": "user", "content": "Hello!"}]
}

POST /v1/messages/count_tokens

요청 전 입력 토큰 수를 추정합니다. Claude Code 가 자동으로 호출하는 엔드포인트입니다.

  • 무과금 — 크레딧이 차감되지 않습니다.
  • 업스트림 프로바이더를 호출하지 않고 휴리스틱 추정치를 반환합니다(정확한 토크나이저 결과와 다를 수 있음).
  • 요청 본문은 /v1/messages 와 동일한 형태를 받습니다.
{
  "input_tokens": 1234
}