텍스트
메시지 토큰 수 계산
응답을 생성하지 않고 Messages 요청의 입력 토큰 수를 계산합니다.
개요
메시지 생성와 동일한 model, messages, system, tools, thinking 필드를 전송하되 max_tokens는 제외하여, 요청을 보내기 전에 입력 토큰 수를 계산합니다. 모델의 accepted_request_formats에 anthropic_messages가 포함되어 있어야 합니다.
참고 사항
- 토큰 계산에는 API 키가 필요하며 요금이 청구되지 않습니다.
- 이 계산은 계획 수립을 위한 것입니다. 실제 요청에 대한 비용은 응답의
usage를 기준으로 청구됩니다. - TokenLab은 모델 자체 카운터의 계산값을 우선합니다. 해당 카운터를 사용할 수 없는 경우, TokenLab은 로컬 추정치를 반환하고 응답 헤더
X-TokenLab-Count-Tokens-Source: local_estimate를 설정합니다. - 인증, 권한 및 입력 오류 발생 시 요청은 실패합니다.
file_id를 참조하는 요청은 모델 자체 카운터가 필요하며, 카운터를 사용할 수 없는 경우503오류를 반환합니다. 이러한 요청 시anthropic-beta: files-api-2025-04-14를 함께 전송하십시오.
요청
curl -X POST "https://api.tokenlab.sh/v1/messages/count_tokens" \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5",
"messages": [
{"role": "user", "content": "Hello, Claude!"}
]
}'응답
{
"input_tokens": 12
}주요 필드
input_tokensinteger
요청에 포함된 예상 입력 토큰 수입니다.
인증
BearerAuth AuthorizationBearer <token>
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json