개요
이 엔드포인트는 Anthropic Messages API와의 네이티브 호환성을 제공합니다. extended thinking과 같은 기능이 있는 Claude 모델에 이것을 사용하세요. 이 엔드포인트는 Anthropic 네이티브 계약을 유지합니다.messages는 user / assistant 메시지 배열이어야 하며, system은 최상위 system 필드에 두어야 하고 max_tokens는 필수입니다. payload가 messages 안에서 OpenAI 역할인 system, developer, tool을 사용한다면 /v1/chat/completions로 보내세요.
Anthropic SDK의 Base URL:
https://api.tokenlab.sh (/v1 접미사 없음)요청 헤더
string
필수
TokenLab API 키입니다. Bearer token의 대안입니다.
string
필수
Anthropic API 버전입니다.
2023-06-01을 사용하세요.요청 본문
string
필수
Claude 모델 ID입니다(예:
claude-sonnet-4-6 또는 claude-opus-4-6).array
필수
role 및 content를 포함하는 메시지 객체의 배열입니다.integer
필수
생성할 최대 token 수입니다.
string
System prompt입니다(messages 배열과 별도).
number
기본값:"1"
Sampling temperature입니다(0-1).
boolean
기본값:"false"
스트리밍 응답을 활성화합니다.
object
Extended thinking 구성입니다(Claude Opus 4.5).
type(string): 활성화하려면"enabled"budget_tokens(integer): thinking을 위한 token 예산
array
모델에서 사용할 수 있는 도구입니다.
object
모델이 도구를 사용하는 방식입니다. 옵션:
auto, any, tool(특정 도구).number
Nucleus sampling 파라미터입니다. temperature 또는 top_p 중 하나만 사용하고, 둘 다 사용하지 마세요.
integer
각 token에 대해 상위 K개 옵션에서만 샘플링합니다.
array
모델이 생성을 중지하게 하는 사용자 지정 stop sequence입니다.
object
추적 목적으로 요청에 첨부할 metadata입니다.
응답
string
고유한 메시지 식별자입니다.
string
항상
message입니다.string
항상
assistant입니다.array
content block의 배열입니다(text, thinking, tool_use).
string
사용된 모델입니다.
string
생성이 중지된 이유입니다(
end_turn, max_tokens, tool_use).object
input_tokens 및 output_tokens를 포함한 token 사용량입니다.비전 입력 예시
비전 지원이 있는 Claude 모델의 경우, 이미지를 구조화된 이미지 블록으로messages[].content 안에 넣으세요.
Extended Thinking 예시
Anthropic 메시지 배치
TokenLab는/v1/messages 와 함께 Anthropic Message Batches 네이티브 흐름도 제공합니다.
사용 가능한 라우트:
POST /v1/messages/batchesGET /v1/messages/batchesGET /v1/messages/batches/:message_batch_idGET /v1/messages/batches/:message_batch_id/resultsPOST /v1/messages/batches/:message_batch_id/cancelDELETE /v1/messages/batches/:message_batch_id
- 동일한 TokenLab API key 와 Anthropic 네이티브 헤더를 사용하세요.
- batch item 이
file_id를 참조하는 경우anthropic-beta: files-api-2025-04-14도 함께 포함하세요. - Batch job 은 Anthropic 네이티브 요청/응답 형태를 유지하면서, TokenLab 가 내부 정산 수명주기를 추적합니다.