Capacités

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èle
Optimiser les invites pour qu'elles aient une longueur spécifique

Comment compter les jetons des messages

Le point de terminaison de 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

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 }

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.

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 }

Compter les jetons dans les messages avec des images

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

Compter les jetons dans les messages avec 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

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-5",
      "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 }

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.

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 }

Tarification et limites de débit

Le comptage des jetons est gratuit mais soumis aux limites de taux de requêtes 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	Requêtes 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?

Capacités

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.

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

Comment compter les jetons des messages

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.

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

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 }

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.

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 }

Compter les jetons dans les messages avec des images

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

Compter les jetons dans les messages avec 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

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-5",
      "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 }

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.

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 }

Tarification et limites de débit

Niveau d'utilisation	Requêtes 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?

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 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 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 ?