TokenLab

텍스트

메시지 토큰 수 계산

응답을 생성하지 않고 Messages 요청의 입력 토큰 수를 계산합니다.

POST
/v1/messages/count_tokens

개요

메시지 생성와 동일한 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
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!"}
    ]
  }'

응답 예시

응답

200 OK
{
  "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