Gestion du contexte

Comptage des jetons

Déterminez le nombre de jetons dans un message avant de l'envoyer à Claude pour prendre des décisions éclairées sur vos invites et votre utilisation.

Le comptage des jetons vous permet de déterminer le nombre de jetons dans un message avant de l'envoyer à Claude, ce qui vous aide à prendre des décisions éclairées sur vos invites et votre utilisation. Avec le comptage des jetons, vous pouvez

Gérer de manière proactive les limites de débit et les coûts
Prendre des décisions intelligentes de routage de modèles
Optimiser les invites pour qu'elles aient une longueur spécifique

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

Comment compter les jetons des messages

Le point de terminaison comptage des jetons accepte la même liste structurée d'entrées pour créer un message, y compris la prise en charge des invites système, des outils, des images et des PDF. La réponse contient le nombre total de jetons d'entrée.

Le comptage des jetons doit être considéré comme une estimation. Dans certains cas, le nombre réel de jetons d'entrée utilisés lors de la création d'un message peut différer légèrement.

Les comptages de jetons peuvent inclure des jetons ajoutés automatiquement par Anthropic pour les optimisations système. Vous ne serez pas facturé pour les jetons ajoutés par le système. La facturation reflète uniquement votre contenu.

Modèles pris en charge

Tous les modèles actifs prennent en charge le comptage des jetons.

Compter les jetons dans les messages de base

JSON

{ "input_tokens": 14 }

Compter les jetons dans les messages avec des outils

Les comptages de jetons des outils serveur ne s'appliquent qu'à l'appel d'échantillonnage initial.

JSON

{ "input_tokens": 403 }

Compter les jetons dans les messages avec des images

JSON

{ "input_tokens": 1551 }

Compter les jetons dans les messages avec la réflexion étendue

Voir ici pour plus de détails sur la façon dont la fenêtre de contexte est calculée avec la réflexion étendue

Les blocs de réflexion des tours d'assistant précédentes sont ignorés et ne comptent pas vers vos jetons d'entrée
La réflexion du tour d'assistant actuel compte vers vos jetons d'entrée

JSON

{ "input_tokens": 88 }

Compter les jetons dans les messages avec des PDF

Le comptage des jetons prend en charge les PDF avec les mêmes limitations que l'API Messages.

JSON

{ "input_tokens": 2188 }

Tarification et limites de débit

Le comptage des jetons est gratuit mais soumis aux limites de débit des demandes par minute en fonction de votre niveau d'utilisation. Si vous avez besoin de limites plus élevées, contactez l'équipe commerciale via la Console Claude.

Niveau d'utilisation	Demandes par minute (RPM)
1	100
2	2 000
3	4 000
4	8 000

Le comptage des jetons et la création de messages ont des limites de débit séparées et indépendantes -- l'utilisation de l'un ne compte pas contre les limites de l'autre.

FAQ

Was this page helpful?

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

Comment compter les jetons des messages

Modèles pris en charge

Compter les jetons dans les messages de base

Compter les jetons dans les messages avec des outils

Compter les jetons dans les messages avec des images

Compter les jetons dans les messages avec la réflexion étendue

Compter les jetons dans les messages avec des PDF

Tarification et limites de débit

FAQ

Le comptage des jetons utilise-t-il la mise en cache des invites ?

Comment compter les jetons des messages

Modèles pris en charge

Compter les jetons dans les messages de base

Compter les jetons dans les messages avec des outils

Compter les jetons dans les messages avec des images

Compter les jetons dans les messages avec la réflexion étendue

Compter les jetons dans les messages avec des PDF

Tarification et limites de débit

FAQ

Le comptage des jetons utilise-t-il la mise en cache des invites ?