Tarification et jetons pour l'utilisation des outils
Les requêtes d’utilisation d’outils sont facturées de la même manière que toute autre requête de l’API Claude, en fonction du nombre total de jetons d’entrée envoyés au modèle (y compris dans le paramètre tools
) et du nombre de jetons de sortie générés.
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èle | Choix d’outil | Nombre de jetons d’invite système pour l’utilisation d’outils |
---|---|---|
Claude 3 Opus | auto | 530 jetons |
Claude 3 Opus | any , tool | 281 jetons |
Claude 3 Sonnet | auto | 159 jetons |
Claude 3 Sonnet | any , tool | 235 jetons |
Claude 3 Haiku | auto | 264 jetons |
Claude 3 Haiku | any , tool | 340 jetons |
Claude 3 Opus (version bêta héritée : tools-2024-04-04 ) | auto | 395 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.