Messages API (Anthropic)
Anthropic 네이티브 Messages API를 BizRouter를 통해 사용할 수 있습니다. Claude Code 등 Anthropic SDK 기반 도구와의 직접 연동을 지원합니다. 대부분의 경우 Chat Completions API로 충분합니다 Anthropic Claude 모델은 Chat Completions API 로도 호출할 수 있습니다. 또한 Chat Completions에서도 anthropic-beta / x-anthropic-beta 헤더와 anthropic_beta extra 파라미터를 지원합니다. 이 엔드포인트는 Extended Thinking, Prompt Caching, Claude Code 직접 연동 등 Anthropic 네이티브 기능이 필요한 경우에만 사용하십시오.
엔드포인트 개요
Anthropic Messages API 엔드포인트 POST /v1/messages 메시지 생성 (Anthropic 네이티브 형식) POST /v1/messages/count_tokens 요청을 실행하지 않고 입력 token 수 계산 Base URL: https://api.bizrouter.ai 인증: x-api-key 헤더 또는 Authorization: Bearer 헤더 버전 헤더: anthropic-version 을 생략하면 2023-06-01 이 적용됩니다.
입력 token 계산
메시지를 생성하기 전에 Anthropic-compatible 입력 token 수를 확인합니다. max_tokens 와 stream 은 필요하지 않습니다. 이 endpoint는 생성 요청을 실행하거나 생성 token 비용을 청구하지 않습니다. Anthropic provider가 선택된 Claude 모델은 Anthropic의 native token count를 사용하며, 스마트 라우팅 route ID와 그 외 provider 경로는 요청 내용을 외부 provider로 전송하지 않고 BizRouter의 deterministic local estimate를 반환합니다.
인증
API 요청에 인증 정보를 포함하는 방법 x-api-key (Anthropic 네이티브) Authorization: Bearer (OpenAI 호환) 선택 헤더: anthropic-version: 2023-06-01 — 생략 시 동일한 기본값 적용 선택 헤더: anthropic-beta / x-anthropic-beta — 베타 기능 활성화 (예: prompt-caching-2024-07-31 ). 검토된 기능 계열(interleaved-thinking, prompt-caching, prompt-caching-scope, extended-cache-ttl, output-128k, token-efficient-tools, fine-grained-tool-streaming, structured-outputs, effort, context-management, thinking-token-count, mid-conversation-system, advanced-tool-use, computer-use, pdfs, claude-code, oauth, web-search)만 Anthropic으로 전달됩니다. 그 밖의 토큰은 전달되지 않고 제거되며, 제거된 토큰은 응답 헤더 x-bizrouter-beta-dropped 에 표시됩니다 (별도 과금 체계가 마련되기 전까지 context-1m 도 제거 대상입니다). code-execution, files-api, mcp-client, skills 계열은 요청 자체가 400으로 거절됩니다.
advisor 도구
advisor 실행을 제외한 Messages 요청 처리 BizRouter는 Anthropic의 advisor 서버 도구 실행을 지원하지 않습니다. 선택적으로 포함된 advisor_* 도구는 요청에서 제거하고 나머지 요청을 처리합니다. 제거된 도구의 type은 성공 응답의 x-bizrouter-tool-dropped 헤더로 확인할 수 있습니다. advisor 실행 비용은 발생하지 않으며, 기본 모델의 요청은 일반 과금 기준을 따릅니다. tool_choice 가 advisor를 이름으로 지정하거나, advisor만 있는 요청에서 any 로 도구 호출을 강제하면 400으로 거절됩니다. 도구가 모두 제거될 때 선택 방식이 생략되었거나 auto 또는 none 이면 도구 목록과 선택 설정을 함께 제거합니다. 토큰 카운트에도 같은 제거 규칙을 적용합니다.
모델 매핑
Claude Code 모델명과 BizRouter 내부 모델 매핑 요청 모델명 패턴 BizRouter 매핑 claude-fable-* BizRouter 내부 Fable 모델 claude-opus-* BizRouter 내부 Opus 모델 claude-sonnet-* BizRouter 내부 Sonnet 모델 claude-haiku-* BizRouter 내부 Haiku 모델 bizrouter/route 스마트 라우팅이 요청을 분석해 최적 모델 자동 선택 카탈로그 모델 코드(예: openai/gpt-* , google/gemini-* ) 해당 모델 직접 사용(Messages↔Chat 자동 변환) 자동 모델 매핑 Claude Code가 보내는 모델명(예: claude-sonnet-4-5-20250929 )은 BizRouter가 자동으로 내부 모델로 매핑합니다. 조직에 Claude Code family override가 설정되어 있으면 해당 정책을 우선 적용하고, 없을 때 exact catalog match와 family fallback 순서로 모델을 선택합니다. 별도의 모델명 변환 작업이 필요 없습니다. 호환 카탈로그 모델과 스마트 라우팅 지원 이 엔드포인트는 Claude 모델 외에도 활성화된 text-output catalog model 중 Messages 변환 경로와 호환되는 모델 코드, 그리고 bizrouter/route 스마트 라우팅을 지원합니다. Claude 외 모델과 스마트 라우팅으로 선택된 모델은 Messages↔Chat Completions 변환 경로로 실행되며, tool use를 포함한 왕복 변환이 지원됩니다. 등록되지 않았거나 API key 정책상 허용되지 않은 모델은 요청할 수 없습니다.
요청 형식
Messages API 요청 파라미터
요청 형식 · MessageItem
대화 메시지 항목입니다. content 는 단순 문자열 또는 콘텐츠 블록 배열을 사용할 수 있습니다. document 블록은 현재 Anthropic Provider에서만 지원됩니다. Smart Routing은 document 요청을 Anthropic으로 제한하며, 다른 Provider를 직접 지정하면 요청을 거부합니다.
요청 형식 · SystemBlock
system 파라미터에 문자열 대신 배열을 사용하면 Prompt Caching을 적용할 수 있습니다.
요청 형식 · Tool
도구 정의입니다. input_schema 는 JSON Schema 형식을 따릅니다.
요청 형식 · ToolChoice
도구 사용 방식을 제어합니다.
요청 형식 · ThinkingConfig
Extended Thinking 활성화 설정입니다. budget_tokens 는 사고 과정에 사용할 최대 토큰 수이며, max_tokens 보다 작아야 합니다.
응답 형식
Messages API 응답 구조
응답 형식 · 응답 예시
cost_krw 는 해당 요청에 청구되는 KRW 요금입니다. 입력·출력 토큰과 캐시 읽기·쓰기 토큰을 각각의 단가로 계산한 뒤 조직 정산 조건과 Smart Routing analyzer 비용을 반영한 값이므로, 모델 단가표를 직접 계산하지 않고 이 값을 그대로 사용할 수 있습니다. 스트리밍 응답에서는 마지막 message_delta 이벤트의 usage에 동일한 필드가 포함됩니다. 일반적인 완료에서는 stop_details 가 null 입니다. Anthropic streaming classifier가 응답을 거부하면 stop_reason: "refusal" 과 함께 거부 유형·카테고리·설명이 담긴 구조화 객체가 반환될 수 있습니다.
Extended Thinking 지원
Claude의 사고 과정을 확인할 수 있는 Extended Thinking 기능 Extended Thinking을 활성화하면 Claude가 응답을 생성하기 전에 내부적으로 사고 과정을 거칩니다. 사고 과정은 응답의 thinking 콘텐츠 블록으로 반환됩니다. Anthropic 이외의 모델을 이 엔드포인트로 호출할 때도 thinking 은 그 모델의 추론 스위치로 옮겨집니다. 자체 서빙 모델( bizrouter/qwen-3.8-flash )은 기본으로 추론을 켠 채 답하므로, JSON 추출처럼 짧은 답이 필요하면 "thinking": {"type": "disabled"} 를 보내야 숨은 추론 토큰이 max_tokens 를 먹지 않습니다. enabled · adaptive 는 모델 기본값(추론 켬)이며 budget_tokens 는 이 모델에 대응하는 값이 없어 적용되지 않습니다. 이때 추론 내용은 응답에 포함되지 않고 토큰 수만 usage.thinking_tokens 로 보고됩니다(모델이 분리해 주는 경우).
Extended Thinking 지원 · 응답 예시
토큰 사용량 참고 Extended Thinking에서 사용되는 사고 토큰은 output_tokens 에 포함되어 과금됩니다. budget_tokens 를 적절히 설정하여 비용을 관리하십시오.
Prompt Caching
반복되는 프롬프트 비용을 절감하는 캐싱 기능 시스템 프롬프트나 긴 컨텍스트를 캐싱하여 반복 요청 시 입력 token 비용을 절감할 수 있습니다. 캐시 read/write token은 별도로 집계되며 적용 가격은 모델과 Provider의 현재 pricing 설정에 따라 달라집니다.
Prompt Caching · OpenAI GPT-5.6+ explicit caching
OpenAI 모델에는 Anthropic의 cache_control 대신 request-level prompt_cache_key / prompt_cache_options 와 content block의 prompt_cache_breakpoint 를 사용합니다. BizRouter는 이 필드를 OpenAI Chat Completions 형식으로 lossless 변환합니다. mode: "explicit" 에서 breakpoint를 하나도 지정하지 않으면 caching과 cache-write 과금이 발생하지 않습니다. 이 기능은 OpenAI GPT-5.6 이상 모델용이며, 이전 모델 또는 다른 Provider는 요청을 거부할 수 있습니다.
Prompt Caching · 선택 header
BizRouter는 anthropic-beta 를 Provider로 전달합니다. 필요한 flag는 선택한 모델의 현재 Provider 문서를 기준으로 추가하십시오.
Prompt Caching · 캐싱 사용량 응답
캐싱 사용 시 응답의 usage 객체에 캐시 관련 필드가 추가됩니다: cache_creation_input_tokens — 캐시에 새로 저장된 토큰 수 (캐시 생성 비용 발생) cache_read_input_tokens — 캐시에서 읽은 토큰 수 (할인 비용 적용) OpenAI의 prompt_tokens_details.cache_write_tokens 도 Messages 응답에서는 cache_creation_input_tokens 로 정규화됩니다.
스트리밍
Anthropic SSE 이벤트 기반 스트리밍 요청에 stream: true 를 설정하면 Anthropic 고유의 이벤트 기반 SSE 형식으로 응답이 스트리밍됩니다.
스트리밍 · 주요 SSE 이벤트
event: message_start 초기 메타데이터 (메시지 ID, 모델, usage 등) event: content_block_start 콘텐츠 블록 시작 (text, thinking, tool_use 등) event: content_block_delta 증분 콘텐츠 (실시간 텍스트 스트리밍) event: content_block_stop 콘텐츠 블록 완료 event: message_delta 최종 메타데이터 (stop_reason, stop_sequence, stop_details, usage) event: message_stop 스트림 종료
스트리밍 · 스트리밍 처리 예시
Python Node.js
Claude Code 연동 퀵 레퍼런스
Claude Code에서 BizRouter를 바로 사용하기
Claude Code 연동 퀵 레퍼런스 · 환경 변수 설정
위 설정만으로 Claude Code에서 BizRouter를 통해 Claude 모델을 사용할 수 있고, /model 선택창에는 이 키로 쓸 수 있는 Claude 모델이 자동으로 채워집니다. settings.json 배포, 모델 고정, GitHub Actions, 폐쇄망 설정은 개발 도구 연동 문서를 참고하십시오. Claude Code가 보내는 claude-fable-* , claude-opus-* , claude-sonnet-* , claude-haiku-* 요청은 BizRouter 내부 모델로 자동 매핑됩니다. Base URL 주의사항 Claude Code는 반드시 ANTHROPIC_BASE_URL=https://api.bizrouter.ai/claude 로 설정하십시오. /v1 경로는 포함하지 않습니다.
요청 예시
다양한 언어와 환경에서의 Messages API 사용 cURL Python Node.js