Comptage de tokens (Anthropic)

Estime la taille d'une entrée Messages sans générer de réponse.

POST https://api.cloudzir.com/anthropic/v1/messages/count_tokens

Authentification#

x-api-key: zir_ai_<48 caractères hexadécimaux>
content-type: application/json
anthropic-version: 2023-06-01

Authorization: Bearer … fonctionne aussi.

Paramètres#

Champ	Type	Description
`model` requis	string	Identifiant d'un modèle disponible sur `GET /anthropic/v1/models`.
`messages` requis	array non vide	Messages `user` et `assistant`. Le contenu peut être une chaîne ou des blocs textuels et d'outils.
`system`	string ou array	Texte système, ou liste de blocs `text`. Inclus dans l'estimation.
`tools`	array	Outils avec `name` et `input_schema`. Leurs définitions sont incluses dans l'estimation.

Requête#

curl https://api.cloudzir.com/anthropic/v1/messages/count_tokens \
  -H "x-api-key: $CLOUDZIR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "mina-low",
    "system": "Réponds brièvement.",
    "messages": [{"role": "user", "content": "Bonjour Mina"}]
  }'

Réponse#

{"input_tokens": 21}

En-tête	Valeur
`X-CloudZIR-Token-Count-Estimated`	`true`
`X-CloudZIR-Token-Count-Method`	`unicode_chars_div_4`

Le résultat est une estimation, pas le décompte exact du tokenizer du modèle. La route ne débite pas la génération.

Erreurs et limites#

400, 401, 403, 404, 413, 429, 500, 503. Les images et documents dans le contenu sont refusés en 400. Les plafonds du corps JSON, de profondeur et de taille des listes sont configurés côté serveur. Le modèle doit être activé pour la clé, mais le comptage ne consomme pas le solde de génération. Voir les codes d'erreur.