Подсчет токенов

Подсчет токенов позволяет вам определить количество токенов в сообщении перед отправкой его Claude, помогая вам принимать обоснованные решения о ваших подсказках и использовании. С помощью подсчета токенов вы можете

Активно управлять ограничениями скорости и затратами
Принимать умные решения о маршрутизации моделей
Оптимизировать подсказки до определенной длины

This feature is Zero Data Retention (ZDR) eligible. When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

Как подсчитать токены сообщения

Конечная точка подсчета токенов принимает тот же структурированный список входных данных для создания сообщения, включая поддержку системных подсказок, инструментов, изображений и PDF-файлов. Ответ содержит общее количество входных токенов.

Подсчет токенов следует рассматривать как оценку. В некоторых случаях фактическое количество входных токенов, используемых при создании сообщения, может отличаться на небольшую величину.

Подсчеты токенов могут включать токены, автоматически добавляемые Anthropic для системной оптимизации. Вам не выставляется счет за добавленные системой токены. Выставление счетов отражает только ваше содержимое.

Поддерживаемые модели

Все активные модели поддерживают подсчет токенов.

Подсчет токенов в базовых сообщениях

JSON

{ "input_tokens": 14 }

Подсчет токенов в сообщениях с инструментами

Подсчеты токенов серверного инструмента применяются только к первому вызову выборки.

JSON

{ "input_tokens": 403 }

Подсчет токенов в сообщениях с изображениями

JSON

{ "input_tokens": 1551 }

Подсчет токенов в сообщениях с расширенным мышлением

Смотрите здесь для получения дополнительной информации о том, как контекстное окно рассчитывается с расширенным мышлением

Блоки мышления из предыдущих ходов ассистента игнорируются и не учитываются в ваших входных токенах
Мышление текущего хода ассистента учитывается в ваших входных токенах

JSON

{ "input_tokens": 88 }

Подсчет токенов в сообщениях с PDF-файлами

Подсчет токенов поддерживает PDF-файлы с теми же ограничениями, что и API Messages.

JSON

{ "input_tokens": 2188 }

Цены и ограничения скорости

Подсчет токенов бесплатен в использовании, но подлежит ограничениям на количество запросов в минуту на основе вашего уровня использования. Если вам нужны более высокие ограничения, свяжитесь с отделом продаж через Claude Console.

Уровень использования	Запросов в минуту (RPM)
1	100
2	2,000
3	4,000
4	8,000

Подсчет токенов и создание сообщений имеют отдельные и независимые ограничения скорости -- использование одного не учитывается в отношении ограничений другого.

Часто задаваемые вопросы

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    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"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())

#!/bin/sh

IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl "$IMAGE_URL" | base64)

curl https://api.anthropic.com/v1/messages/count_tokens \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-6",
    "messages": [
        {"role": "user", "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "'$IMAGE_MEDIA_TYPE'",
                "data": "'$IMAGE_BASE64'"
            }},
            {"type": "text", "text": "Describe this image"}
        ]}
    ]
}'

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-sonnet-4-6",
      "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
      },
      "messages": [
        {
          "role": "user",
          "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?"
        },
        {
          "role": "assistant",
          "content": [
            {
              "type": "thinking",
              "thinking": "This is a nice number theory question. Lets think about it step by step...",
              "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV..."
            },
            {
              "type": "text",
              "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3..."
            }
          ]
        },
        {
          "role": "user",
          "content": "Can you write a formal proof?"
        }
      ]
    }'

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-opus-4-6",
      "messages": [{
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "base64",
              "media_type": "application/pdf",
              "data": "'$(base64 -i document.pdf)'"
            }
          },
          {
            "type": "text",
            "text": "Please summarize this document."
          }
        ]
      }]
    }'

Как подсчитать токены сообщения

Поддерживаемые модели

Подсчет токенов в базовых сообщениях

Подсчет токенов в сообщениях с инструментами

Подсчет токенов в сообщениях с изображениями

Подсчет токенов в сообщениях с расширенным мышлением

Подсчет токенов в сообщениях с PDF-файлами

Цены и ограничения скорости

Часто задаваемые вопросы

Использует ли подсчет токенов кэширование подсказок?