Управление контекстом

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

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

Подсчет токенов позволяет вам определить количество токенов в сообщении перед отправкой его 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 для системной оптимизации. Вам не выставляется счет за добавленные системой токены. Выставление счетов отражает только ваше содержимое.

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

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

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

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())

JSON

{ "input_tokens": 14 }

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

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

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())

JSON

{ "input_tokens": 403 }

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

#!/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"}
        ]}
    ]
}'

JSON

{ "input_tokens": 1551 }

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

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

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

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?"
        }
      ]
    }'

JSON

{ "input_tokens": 88 }

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

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

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."
          }
        ]
      }]
    }'

JSON

{ "input_tokens": 2188 }

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

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

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

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

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

Was this page helpful?

Управление контекстом

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

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

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.

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

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

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

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

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())

JSON

{ "input_tokens": 14 }

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

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

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())

JSON

{ "input_tokens": 403 }

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

#!/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"}
        ]}
    ]
}'

JSON

{ "input_tokens": 1551 }

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

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

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?"
        }
      ]
    }'

JSON

{ "input_tokens": 88 }

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

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

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."
          }
        ]
      }]
    }'

JSON

{ "input_tokens": 2188 }

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

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

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

Was this page helpful?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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