Claude Messages Count Tokens API demande et utilisation

Claude Messages Count Tokens API peut calculer le nombre de tokens d’une message d’entrée sans réellement créer de message, y compris le comptage des tokens pour des outils, images et documents. Cela est très utile pour estimer les coûts ou vérifier si l’entrée dépasse les limites de contexte du modèle. Ce document présente principalement le processus d’utilisation de Claude Messages Count Tokens API.

Processus de demande

Pour utiliser Claude Messages Count Tokens API, commencez par obtenir votre API Token sur le tableau de bord Ace Data Cloud pour référence.

Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle. Un API Token suffit pour appeler tous les services de la plateforme, sans avoir besoin de demander séparément pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; si le quota est insuffisant, vous pouvez recharger le solde général dans le tableau de bord.

📘 Documentation complète : Claude Messages Count Tokens API →

Utilisation de base

Le chemin de requête pour Claude Messages Count Tokens API est /v1/messages/count_tokens, en accord avec l’API officielle d’Anthropic. Nous devons fournir au moins deux paramètres obligatoires :

model : choisissez le modèle Claude à utiliser, comme le dernier modèle phare claude-fable-5-1 ; l’ancien claude-fable-5 reste compatible.
messages : tableau de messages d’entrée, chaque message contenant role (rôle) et content (contenu).

Paramètres optionnels courants :

system : message système, qui sera compté dans le nombre de tokens.
tools : définition des outils, qui sera comptée dans le nombre de tokens.
thinking : configuration de réflexion étendue.
tool_choice : configuration de choix d’outils.
cache_control : configuration de contrôle de cache au niveau supérieur ou au niveau des blocs de contenu.

messages, system, les appels d’outils, les images URL et les blocs de contenu document/PDF utilisent la même structure de requête stable que l’API Messages.

Exemple cURL

curl -X POST 'https://api.acedata.cloud/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-fable-5-1",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

Exemple Python

import httpx

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

Exemple de résultat retourné :

{
  "input_tokens": 11
}

Utilisation du SDK Anthropic

Claude Messages Count Tokens API accepte la structure de requête stable du SDK Anthropic et peut être appelée via la bibliothèque anthropic. La valeur de retour actuelle est calculée par l’estimateur local d’Ace Data Cloud et n’est pas le résultat précis du tokenizer officiel d’Anthropic ; le nombre réel de tokens pour les multimédias, outils et différents modèles Claude peut varier.

from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.acedata.cloud",
)

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

Comptage des tokens incluant des outils

Si votre demande inclut des définitions d’outils, ces outils seront également comptés dans le nombre de tokens :

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    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)

Comptage des tokens incluant des messages système

Les messages système seront également comptés dans le nombre de tokens :

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

Remarques

Cette API ne calcule que le nombre de tokens d’entrée et ne produira aucune sortie du modèle.
Les résultats du comptage des tokens peuvent être utilisés pour une estimation approximative de l’échelle d’entrée, mais ne doivent pas être considérés comme une base pour une facturation précise, un contrôle d’accès à la fenêtre de contexte ou une comparaison avec le tokenizer du modèle.
L’estimateur actuel ne calculera pas précisément les tokens visuels/documents pour les images et les PDF, et ne peut pas refléter les différences du tokenizer officiel entre les différents modèles Claude.
Cette API est entièrement gratuite et ne consomme aucun quota.

Démarrage

Chat IA

Image IA

Vidéo IA

Audio IA

Web & Données

CAPTCHA

Identité

Proxy

Avancé

Coding

Claude Messages Count Tokens API demande et utilisation

Processus de demande

Utilisation de base

Exemple cURL

Exemple Python

Utilisation du SDK Anthropic

Comptage des tokens incluant des outils

Comptage des tokens incluant des messages système

Remarques

​Processus de demande

​Utilisation de base

​Exemple cURL

​Exemple Python

​Utilisation du SDK Anthropic

​Comptage des tokens incluant des outils

​Comptage des tokens incluant des messages système

​Remarques

Processus de demande

Utilisation de base

Exemple cURL

Exemple Python

Utilisation du SDK Anthropic

Comptage des tokens incluant des outils

Comptage des tokens incluant des messages système

Remarques