Présentation
Vous pouvez examiner l’utilisation de l’API de deux façons :
Utilisez le tableau de bord d’utilisation pour examiner l’activité des périodes de facturation actuelles et passées.
Consultez les informations d’utilisation dans une réponse de l’API pour vérifier une requête individuelle.
Le Playground utilise les mêmes appels d’API que vos applications. Ses tokens sont comptabilisés dans l’utilisation de l’API de votre compte et suivent les mêmes règles d’utilisation et la même tarification.
Accès au tableau de bord
Vous devez être propriétaire de l’organisation ou disposer de l’autorisation Tableau de bord d’utilisation pour accéder à ce tableau de bord.
Examiner l’utilisation dans le tableau de bord
Ouvrez le tableau de bord d’utilisation, sélectionnez l’organisation à examiner, puis choisissez la période de rapport souhaitée.
Les données du tableau de bord sont affichées en UTC. Tenez compte de ce fuseau horaire lorsque vous comparez l’activité du tableau de bord aux journaux de votre application.
Sélectionner des projets
Le tableau de bord possède son propre sélecteur de projets. Il fonctionne indépendamment du projet sélectionné ailleurs dans la Plateforme API.
Utilisez le sélecteur du tableau de bord pour examiner un, plusieurs ou tous les projets. Pour afficher les données globales de l’organisation, désélectionnez les projets. Si aucun projet n’est sélectionné, le tableau de bord affiche les données de tous les projets.
Examiner l’utilisation d’un utilisateur
Pour examiner l’utilisation de Responses et Chat Completions par un utilisateur :
Dans le tableau de bord d’utilisation, accédez à Fonctionnalités de l’API > Responses et Chat Completions.
Sélectionnez Filtrer par.
Sous Utilisateurs, sélectionnez l’utilisateur, puis Appliquer les filtres.
Afficher les tokens par minute
Les pages de détails d’utilisation permettent de sélectionner un intervalle. Sélectionnez un intervalle d’une minute pour examiner les tokens par minute (TPM).
Cet intervalle s’applique aux données d’utilisation, et non aux données de facturation.
Exporter les données d’utilisation
La plage de dates d’exportation n’est pas limitée. Les exportations couvrant une longue période peuvent être réparties dans plusieurs fichiers.
Pour rapprocher les factures mensuelles et exporter les postes, consultez : Exporter les détails mensuels d’utilisation.
Afficher les attributions de crédits
Les détails des attributions de crédits sont disponibles sur la page de facturation de votre organisation.
Les attributions de crédits et l’utilisation de l’API répondent à des questions différentes : les premières indiquent les crédits associés à votre organisation, tandis que l’utilisation indique son activité sur l’API.
Examiner l’utilisation et les coûts de l’offre Scale
Si l’offre Scale est activée pour votre organisation et que vous disposez de l’accès requis, ouvrez la page d’utilisation de l’offre Scale pour obtenir des informations détaillées.
Les coûts des forfaits de l’offre Scale sont attribués à l’organisation, et non aux projets individuels.
L’utilisation est supérieure à zéro, mais les dépenses du projet sont nulles
Vérifiez si l’utilisation du modèle est couverte par votre allocation de l’offre Scale. Si toute l’utilisation de ce modèle est comprise dans l’allocation TPM de l’offre Scale, le projet peut afficher une utilisation sans dépenses supplémentaires liées au modèle.
Le coût de l’abonnement à l’offre Scale reste attribué à l’organisation. Pour le consulter :
Effacez le filtre de projet dans le tableau de bord d’utilisation.
Sélectionnez Catégories de dépenses.
Examiner plusieurs organisations
Le tableau de bord d’utilisation ne regroupe pas les données de coûts ou d’utilisation de plusieurs organisations. Chaque organisation, y compris une sous-organisation, est traitée séparément.
Pour afficher une sous-organisation, sélectionnez-la dans le sélecteur d’organisations.
Si vous avez besoin de rapports consolidés, envisagez d’utiliser des projets au sein d’une même organisation plutôt que des sous-organisations distinctes, ou utilisez l’API d’utilisation pour une analyse personnalisée.
Vérifier l’utilisation des tokens dans une réponse de l’API
Les noms des champs d’utilisation des tokens dépendent du point de terminaison.
| Nombre de tokens | Chat Completions | Responses |
|---|---|---|
| Tokens d’entrée | usage.prompt_tokens | usage.input_tokens |
| Tokens de sortie | usage.completion_tokens | usage.output_tokens |
| Total des tokens | usage.total_tokens | usage.total_tokens |
Par exemple, une réponse Chat Completions peut inclure :
{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}Selon le point de terminaison et le modèle, les détails d’utilisation peuvent aussi inclure le nombre de tokens d’entrée mis en cache et de tokens de raisonnement. Ces données aident à comprendre pourquoi la longueur visible d’une réponse ne reflète pas la totalité des tokens utilisés.
Pour une explication des différentes catégories de tokens, consultez : Comprendre et compter les tokens.
Obtenir les données d’utilisation de Chat Completions en streaming
Pour une requête Chat Completions en streaming, incluez :
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Lorsque include_usage est activé, un fragment supplémentaire précédant data: [DONE] contient les données d’utilisation pour l’ensemble de la requête. Son tableau choices est vide. Dans les autres fragments, usage a la valeur null.
Si le flux est interrompu, vous risquez de ne pas recevoir ce dernier fragment contenant les données d’utilisation. L’absence du dernier fragment ne prouve pas que la requête n’a utilisé aucun token.
Cette configuration est propre à Chat Completions. Pour en savoir plus, consultez la documentation de référence de l’API Chat Completions.