Claude API - Token Counting

Claude API - Token Counting

 

작성 일자 : 2024년 05월 04일

---

 

token illustrated by GPT image generation

 

 

개요

 

Claude API는 OpenAI API와 마찬가지로, 사용자가 입력한 프롬프트의 토큰 길이에 따라 요금이 부과됩니다. 따라서, 토큰을 줄이는 것이 비용을 절감하는 방법 중 하나입니다.

 

API마다 토큰을 계산하는 방법이 다르기 때문에, 인터넷에는 각 API마다 토큰을 계산해주는 사이트들이 존재합니다. 하지만, 부정확한 사이트도 많기 때문에, 직접 계산하는 방법을 알아보겠습니다.

 

---

 

 

토큰 계산 방법

 

호환되는 모델

 

Claude API의 토큰 계산 API는 아래의 모델과 호환됩니다.

• Claude 3.7 Sonnet
• Claude 3.5 Sonnet
• Claude 3.5 Haiku
• Claude 3 Haiku
• Claude 3 Opus

 

---

 

토큰 계산 API

 

Claude API의 토큰 계산 API는 아래와 같습니다.

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "content-type: application/json" \
    --header "anthropic-version: 2023-06-01" \
    --data '{
      "model": "claude-3-7-sonnet-20250219",
      "messages": [{
        "role": "user",
        "content": "달은 지구의 유일한 자연위성이고, 태양계의 위성 중에서는 5번째로 크다. 행성의 크기와 비교하여, 자연위성 중 가장 크다. 지구 중심부터 달 중심까지 거리는 평균 38만 4400km로, 지구 30개가 들어가는 거리이다. 이 거리면 태양계 모든 행성을 그 사이에 줄 세우고도 조금 남는다. 지구에서 태양까지 거리(1AU)의 1/389 보다 작다. 달 지름은 지구의 약 4분의 1, 태양의 약 400분의 1인 3,476 km이다. 달의 부피는 지구의 약 1/50 정도이며, 표면 중력은 지구의 약 17%이다. 달은 지구를 약 27.3일에 일주하며(공전 주기), 지구-달-태양의 위치 변화는 29.5일을 주기로 달라지는 달의 상을 만든다.(삭망 주기)."
      }]
    }'

 

• Postman을 통해서 요청하는 경우, x-api-key와 anthropic-version은 Header에 추가해주어야 합니다.

 

---

 

응답 예시

 

{
    "input_tokens": 352
}