Passer au contenu principal
L’API Claude Messages Count Tokens permet de calculer le nombre de Tokens d’entrée d’un Message sans créer réellement de message, y compris le comptage des Tokens pour les outils, les images et les documents. Cela est très utile lorsqu’il est nécessaire d’estimer les coûts ou de vérifier si l’entrée dépasse la limite de contexte du modèle. Ce document présente principalement le processus d’utilisation de l’API Claude Messages Count Tokens.

Processus de demande

Pour utiliser l’API Claude Messages Count Tokens, rendez-vous d’abord sur la console Ace Data Cloud afin d’obtenir votre API Token et de le conserver pour une utilisation ultérieure. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion afin de vous inviter à vous inscrire et à vous connecter. Une fois terminé, vous reviendrez automatiquement sur la page actuelle. Un seul API Token permet d’appeler tous les services de la plateforme, sans avoir besoin d’en demander un séparément pour chaque service. Lors de votre première demande, un quota gratuit vous sera offert afin de pouvoir essayer le service gratuitement ; lorsque le quota est insuffisant, vous pouvez recharger votre solde général dans la console.
📘 Documentation complète : Claude Messages Count Tokens API →

Utilisation de base

Le chemin de requête de l’API Claude Messages Count Tokens est /v1/messages/count_tokens, identique à celui de l’API officielle d’Anthropic. Nous devons fournir au minimum deux paramètres obligatoires :
  • model : sélectionne le modèle Claude à utiliser ; claude-opus-5-5 peut être utilisé pour Messages Token Count, comme le dernier modèle phare claude-fable-5-1 ; l’ancien claude-fable-5 reste conservé pour compatibilité. claude-sonnet-5-5 a rejoint l’interface native de la série Messages, prend en charge l’entrée d’images et la réflexion adaptative ; ses prix de référence officiels pour l’entrée, la sortie et la lecture du cache sont respectivement de 2, 10 et 0,20 dollars par million de Tokens.
  • messages : tableau des messages d’entrée, chaque message contenant role (rôle) et content (contenu).
Paramètres optionnels courants :
  • system : prompt système, qui sera comptabilisé dans le nombre de Tokens.
  • tools : définition des outils, qui sera comptabilisée dans le nombre de Tokens.
  • thinking : configuration de réflexion étendue.
  • tool_choice : configuration de sélection des outils.
  • cache_control : configuration du contrôle de cache au niveau supérieur ou au niveau des blocs de contenu.
Les structures de requête stables pour messages, system, la relecture d’appels d’outils, les images URL et les blocs de contenu document/PDF sont les mêmes que pour l’API Messages.

Exemple cURL

Exemple Python

Exemple de résultat retourné :

Utilisation du SDK Anthropic

L’API Claude Messages Count Tokens accepte la structure de requête stable du SDK Anthropic et peut être appelée via la bibliothèque anthropic. L’interface utilise la capacité native Count Tokens correspondant au modèle sélectionné pour compter l’entrée, et peut être utilisée pour vérifier la taille de l’entrée avant d’envoyer une requête Messages.

Comptage des Tokens incluant des outils

Si votre requête contient des définitions d’outils, ces outils seront également comptabilisés dans le nombre de Tokens :

Comptage des Tokens incluant un prompt système

Le prompt système sera également comptabilisé dans le nombre de Tokens :

Remarques

  • Cette API calcule uniquement le nombre de Tokens d’entrée et ne produira aucune sortie de modèle.
  • Le résultat du comptage des Tokens peut être utilisé pour estimer la taille de l’entrée et vérifier la fenêtre de contexte ; la facturation finale est basée sur usage dans la réponse Messages réelle.
  • Les images, les PDF, les définitions d’outils, les prompts système et la configuration thinking seront comptabilisés dans le résultat selon les règles d’entrée du modèle sélectionné.
  • Cette API est entièrement gratuite et ne consomme aucun quota.