Dernière mise à jour : 2026-06-22

Surcoût en tokens des appels de fonction

Le surcoût en tokens des appels de fonction est le coût, du côté entrée, qui découle de la mise à disposition d’outils auprès d’un grand modèle de langage. Pour qu’un modèle puisse décider s’il faut appeler un outil et comment, le fournisseur sérialise la définition de chaque outil — son nom, une description en langage naturel et un schéma JSON pour ses paramètres — dans le prompt que lit le modèle. Ces définitions sont constituées de tokens et sont envoyées à chaque requête, qu’un outil finisse par être utilisé ou non. Ce calculateur isole ce surcoût fixe par appel et le coût récurrent qu’il engendre sur un volume d’appels.

Pourquoi les outils sont facturés à chaque appel

Un modèle est sans état entre les requêtes : il ne retient rien d’un appel au suivant, de sorte que les outils qu’il peut utiliser doivent être décrits à nouveau à chaque fois. Il n’existe aucun moyen d’enregistrer un outil une fois et d’y faire référence à moindre coût ensuite — la définition complète voyage dans l’entrée de chaque appel. Une requête où le modèle répond directement, sans rien invoquer, paie quand même les définitions, car elles ont été fournies pour que l’option existe. Le coût croît donc avec le nombre d’outils exposés et la verbosité de leurs schémas, multipliés par la fréquence à laquelle vous appelez le modèle.

La formule

Pour $m$ outils à $t_{tool}$ tokens chacun et $t_w$ tokens d’encadrement autour du bloc d’outils, le surcoût par appel est

Sur $n$ appels, le surcoût total et son coût à un prix d’entrée $p$ par million de tokens sont

La division par $10^6$ convertit le tarif par million en un tarif par token. Les définitions d’outils sont lues par le modèle, elles sont donc facturées au tarif d’entrée, généralement le moins élevé des deux prix publiés.

Exemple chiffré

Prenons un agent exposant 14 outils dont les définitions font en moyenne 120 tokens chacune, avec 18 tokens d’encadrement autour du bloc. Le surcoût par appel est

Sur 25 000 appels à un prix d’entrée de $3 par million de tokens, le coût du surcoût est

Ces $127,35 sont dépensés avant même qu’un message utilisateur ou une réponse du modèle ne soit compté — ils servent uniquement à décrire les outils à chaque requête. Router l’agent pour qu’il n’expose que la poignée d’outils pertinents pour chaque tâche, plutôt que les 14, réduirait ce chiffre plusieurs fois.

Remarques et variantes

Le chiffre par outil dépend fortement de la richesse de description de chaque outil : des descriptions de paramètres détaillées et de nombreux champs optionnels gonflent le schéma, tandis qu’une définition concise reste compacte. Le surcoût mesuré ici concerne uniquement le bloc d’outils ; les tokens de la conversation et les éventuels arguments d’appel d’outil que le modèle émet sont séparés. La mise en cache des prompts peut réduire ce coût répété lorsque le bloc d’outils est stable d’un appel à l’autre, puisqu’une lecture en cache est facturée à un tarif réduit.

Application

Le surcoût des appels de fonction pèse du côté entrée de la facture. Son pendant côté sortie — l’ossature JSON que le modèle écrit en retour lorsqu’il est contraint à un schéma — est traité par le Calcul du surcoût des sorties structurées. Pour chiffrer l’usage de tokens par appel dont ce surcoût est tiré, voir le Calculateur de coût en jetons.