Les jetons supplémentaires provenant de l’utilisation des outils proviennent de :

  • Le paramètre tools dans les requêtes API (noms, descriptions et schémas des outils)
  • Les blocs de contenu tool_use dans les requêtes et réponses API
  • Les blocs de contenu tool_result dans les requêtes API

Lorsque vous utilisez tools, nous incluons également automatiquement une invite système spéciale pour le modèle qui permet l’utilisation des outils. Le nombre de jetons d’utilisation d’outils requis pour chaque modèle est indiqué ci-dessous (à l’exclusion des jetons supplémentaires listés ci-dessus) :

ModèleChoix d’outilNombre de jetons d’invite système pour l’utilisation d’outils
Claude 3 Opusauto530 jetons
Claude 3 Opusany, tool281 jetons
Claude 3 Sonnetauto159 jetons
Claude 3 Sonnetany, tool235 jetons
Claude 3 Haikuauto264 jetons
Claude 3 Haikuany, tool340 jetons
Claude 3 Opus (version bêta héritée : tools-2024-04-04)auto395 jetons

Ces nombres de jetons sont ajoutés à vos jetons d’entrée et de sortie normaux pour calculer le coût total d’une requête. Reportez-vous à notre tableau de présentation des modèles pour connaître les prix actuels par modèle.

Lorsque vous envoyez une invite d’utilisation d’outil, comme pour toute autre requête API, la réponse affichera à la fois le nombre de jetons d’entrée et de sortie dans le cadre des métriques d’usage rapportées.

Gardez à l’esprit que l’utilisation d’outils nécessite souvent plusieurs allers-retours entre votre code et Claude (pour exécuter les outils et renvoyer les résultats), de sorte qu’une seule requête d’utilisateur final peut entraîner plusieurs requêtes API et des coûts de jetons associés. Concevez vos outils et vos invites pour qu’ils soient aussi concis que possible tout en fournissant suffisamment d’informations pour que Claude puisse utiliser efficacement les outils.