> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Messages Count Tokens API 신청 및 사용

> Claude AI 集成指南 - XHuoAPI

Claude Messages Count Tokens API는 실제로 메시지를 생성하지 않고도 메시지의 입력 토큰 수를 계산할 수 있습니다. 여기에는 도구, 이미지 및 문서 등의 내용의 토큰 수 계산이 포함됩니다. 이는 비용을 예측하거나 입력이 모델의 컨텍스트 제한을 초과하는지 확인해야 할 때 매우 유용합니다.

이 문서는 Claude Messages Count Tokens API의 사용 프로세스를 주로 설명합니다.

## 신청 프로세스

Claude Messages Count Tokens API를 사용하려면 먼저 [Claude Messages Count Tokens API](https://api.xhuoapi.ai/documents/claude-messages-count-tokens) 페이지에서 "Acquire" 버튼을 클릭하여 요청에 필요한 자격 증명을 얻을 수 있습니다.

로그인 또는 등록이 되어 있지 않은 경우 자동으로 로그인 페이지로 리디렉션되어 등록 및 로그인을 초대합니다. 로그인 및 등록 후에는 자동으로 현재 페이지로 돌아옵니다.

이 API는 완전히 무료로 사용 가능하며, 할당량을 소모하지 않습니다.

## 기본 사용

Claude Messages Count Tokens API의 요청 경로는 `/v1/messages/count_tokens`이며, Anthropic 공식 API와 일치합니다. 최소한 두 개의 필수 매개변수를 제공해야 합니다:

* `model`: 사용할 Claude 모델을 선택합니다. 예: `claude-sonnet-4-5-20250929`, `claude-opus-4-20250514` 등.
* `messages`: 입력 메시지 배열로, 각 메시지는 `role`(역할)과 `content`(내용)를 포함합니다.

자주 사용되는 선택적 매개변수:

* `system`: 시스템 프롬프트로, 토큰 수에 포함됩니다.
* `tools`: 도구 정의로, 토큰 수에 포함됩니다.
* `thinking`: 확장된 사고 구성입니다.

### cURL 예시

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'
```

### Python 예시

```python theme={null}
import httpx

url = "https://api.xhuoapi.ai/v1/v1/messages/count_tokens"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}
payload = {
    "model": "claude-sonnet-4-5-20250929",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())
```

반환 결과 예시:

```json theme={null}
{
  "input_tokens": 11
}
```

### Anthropic SDK 사용

Claude Messages Count Tokens API는 Anthropic 공식 SDK와 완전히 호환되며, `anthropic` 라이브러리를 사용하여 직접 호출할 수 있습니다.

```python theme={null}
from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.xhuoapi.ai/v1",
)

result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
)
print(result.input_tokens)
```

## 도구 포함 토큰 수 계산

요청에 도구 정의가 포함된 경우, 이러한 도구도 토큰 수에 포함됩니다:

```python theme={null}
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    messages=[
        {
            "role": "user",
            "content": "What is the weather in San Francisco?"
        }
    ],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    }
                },
                "required": ["location"]
            }
        }
    ],
)
print(result.input_tokens)
```

## 시스템 프롬프트 포함 토큰 수 계산

시스템 프롬프트도 토큰 수에 포함됩니다:

```python theme={null}
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)
```

## 주의 사항

* 이 API는 입력 토큰 수만 계산하며, 모델 출력을 생성하지 않습니다.
* 토큰 수 계산 결과는 Claude Messages API 호출 비용을 예측하는 데 사용할 수 있습니다.
* 서로 다른 모델의 토큰화 방식이 다를 수 있으므로, 실제 호출과 동일한 model 매개변수를 사용해야 합니다.
* 이 API는 완전히 무료이며, 어떤 할당량도 소모하지 않습니다.