Aperçu
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 renseignements sur l’utilisation dans une réponse de l’API pour vérifier une demande individuelle.
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 à celui-ci.
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 pertinente.
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 projet, plusieurs projets ou tous les projets. Pour afficher les données globales de l’organisation, désélectionnez les projets. Lorsqu’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 de Chat Completions d’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 sur l’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 en plusieurs fichiers.
Pour le rapprochement des factures mensuelles et l’exportation des postes, consultez : Exporter les détails d’utilisation mensuels.
Afficher les crédits accordés
Les détails sur les crédits accordés sont accessibles à la page de facturation de votre organisation.
Les crédits accordés et l’utilisation de l’API répondent à des questions différentes : les premiers indiquent les crédits associés à votre organisation, tandis que l’utilisation indique son activité dans 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 renseignements détaillés.
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 respecte l’allocation de 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 demeure au niveau de l’organisation. Pour l’examiner :
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 combinés, envisagez d’utiliser des projets au sein d’une seule organisation plutôt que des sous-organisations distinctes, ou utilisez l’API d’utilisation pour effectuer 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 |
| Nombre total de 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 renseignements expliquent pourquoi la longueur visible d’une réponse ne reflète pas son utilisation totale de tokens.
Pour une explication des différentes catégories de tokens, consultez : Comprendre et compter les tokens.
Obtenir l’utilisation des Chat Completions diffusées en continu
Pour une demande Chat Completions en continu, incluez :
| { "stream": true, "stream_options": { "include_usage": true }} |
Lorsque include_usage est activé, un bloc supplémentaire placé avant data: [DONE] contient les données d’utilisation de toute la demande. Son tableau choices est vide. Les autres blocs ont une valeur usage nulle.
Si le flux est interrompu, il se peut que vous ne receviez pas ce dernier bloc d’utilisation. L’absence du dernier bloc ne signifie pas que la demande 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.