OpenAI
Cette page a été traduite automatiquement. Afficher l’article original en anglais.

Examiner l’utilisation et les coûts de l’API

Consultez l’activité API dans Analyses, vérifiez le nombre de tokens dans les réponses API et découvrez les filtres de projet, les exportations et les coûts de l’offre Scale.

Dernière mise à jour : 2 days ago

Vue d’ensemble

Vous pouvez consulter l’utilisation de l’API de deux façons :

  • Utilisez Analyses > Utilisation pour consulter l’activité API sur les périodes de rapport actuelles et passées.

  • Lisez les informations d’utilisation dans une réponse API pour vérifier une requête individuelle.

Le Playground utilise les mêmes appels API que vos applications. Ses tokens sont comptabilisés dans l’utilisation de l’API de votre compte et sont soumis aux mêmes règles d’utilisation et tarifs.

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.

Consulter l’utilisation dans le tableau de bord

Dans la Plateforme API, ouvrez Analyses et sélectionnez Utilisation pour examiner le projet actuel. Pour les rapports à l’échelle de l’organisation, sélectionnez Analyses de l’organisation. Sélectionnez la période de rapport à examiner et vérifiez-la à nouveau après avoir basculé entre les analyses du projet et celles de l’organisation.

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 avec les journaux de votre application.

L’utilisation récente peut mettre du temps à apparaître dans le tableau de bord. Si l’activité récente n’apparaît pas, vérifiez à nouveau plus tard.

Filtrer l’utilisation

Dans les Analyses du projet, l’utilisation est limitée au projet sélectionné. Dans Analyses de l’organisation, utilisez Projet pour sélectionner les projets à examiner. Tous les projets inclut chaque projet de l’organisation, sous réserve des autres filtres sélectionnés.

Utilisez Filtres pour affiner l’utilisation par Sources API, Clés API, Modèles, Utilisateurs ou Niveau de traitement. Sources API vous permet de sélectionner Toutes les sources API, API Agents ou API directe.

Supprimez des sélections individuelles ou sélectionnez Effacer les filtres pour réinitialiser le panneau Filtres. L’effacement des filtres ne fait pas basculer entre les analyses du projet et celles de l’organisation.

Utilisez Filtrer sur le graphique Utilisation pour filtrer par Batch. Sélectionnez Réinitialiser les filtres du graphique pour réinitialiser les filtres de ce graphique.

Si une fonctionnalité ne prend pas en charge les filtres sélectionnés, ses valeurs peuvent être indisponibles. Des valeurs indisponibles ne signifient pas une utilisation nulle.

Si un filtre affiche une erreur d’autorisation, vous n’avez peut-être pas accès à ses options. Cela ne signifie pas qu’aucune utilisation n’a été enregistrée.

Consulter l’utilisation d’un utilisateur

  1. Ouvrez Utilisation dans la vue Analyses du projet ou de l’organisation à examiner. Dans le tableau Fonctionnalités de l’API, sélectionnez Afficher pour Responses et Chat Completions.

  2. Dans Filtres, sélectionnez Utilisateurs, puis l’utilisateur. Les résultats sont immédiatement mis à jour.

  3. Consultez le graphique et le tableau de cet utilisateur.

Pour examiner l’utilisation d’un utilisateur sur l’ensemble des fonctionnalités, appliquez le filtre Utilisateurs dans la vue d’ensemble Utilisation. Pour comparer les utilisateurs, effacez ce filtre et sélectionnez l’onglet Utilisateurs du tableau.

Afficher les tokens par jour, heure ou minute

Lorsque les commandes d’intervalle sont disponibles dans Utilisation, sélectionnez 1j ou 1h pour afficher les tokens par jour ou par heure, ou 1m pour examiner les tokens par minute (TPM). Sélectionnez Auto pour laisser le tableau de bord choisir l’intervalle de temps adapté à votre période de rapport. Ces intervalles s’appliquent aux données d’utilisation, et non aux données de facturation.

Si 1m est désactivé, sélectionnez une période de rapport plus courte ou utilisez Sélectionner pour zoomer et faites glisser le pointeur sur le graphique pour réduire la plage. Sélectionnez ensuite 1m. Appuyez sur Échap pour annuler une sélection de zoom. Sélectionnez la plage de dates actuelle dans la barre d’outils Analyses pour choisir une autre période de rapport.

Consulter les graphiques et tableaux d’utilisation

Utilisez Indicateurs pour sélectionner une ou plusieurs séries à afficher ensemble, notamment Tokens d’entrée, Tokens d’entrée non mis en cache, Tokens d’entrée mis en cache, Tokens d’entrée écrits dans le cache, Tokens audio d’entrée, Tokens de sortie et Tokens audio de sortie. Les indicateurs disponibles dépendent de la fonctionnalité. Utilisez la légende pour identifier chaque série.

Utilisez Regrouper par pour organiser l’utilisation par catégories telles que Projet, Utilisateur ou Modèle, lorsqu’elles sont disponibles. Les filtres déterminent les données d’utilisation incluses ; le regroupement détermine leur affichage. Basculez entre les graphiques en courbes et en barres pour examiner les tendances ou comparer les catégories.

Utilisez les onglets du tableau Utilisation pour consulter les répartitions disponibles. Les tableaux affichent les mesures pertinentes pour chaque ligne, comme les requêtes, les tokens d’entrée et de sortie, ou les unités propres à chaque fonctionnalité.

Dans Fonctionnalités de l’API, sélectionnez Afficher pour une fonctionnalité afin d’ouvrir ses graphiques et répartitions détaillés. Responses et Chat Completions comprend des graphiques distincts pour les Tokens et les Requêtes, ainsi qu’un indicateur Requêtes au modèle. Ses onglets de répartition utilisent les mêmes dimensions que la vue d’ensemble, sans l’onglet Fonctionnalités de l’API. Utilisez le fil d’Ariane Utilisation pour revenir à la vue d’ensemble.

Après la sélection d’une option Regrouper par, le graphique peut rassembler des catégories supplémentaires dans Autres. Si Autres apparaît dans la légende du graphique, sélectionnez ce libellé pour voir les catégories incluses et leurs valeurs d’utilisation.

Sélectionnez Comparer les tableaux de bord pour afficher Utilisation à côté d’un autre tableau de bord pour la même période de rapport. Utilisez Tableau de bord de gauche et Tableau de bord de droite pour sélectionner les vues. Si l’intervalle de temps sélectionné n’est pas disponible pour les deux tableaux de bord, la vue passe en mode Auto. Sélectionnez Quitter la comparaison pour revenir au tableau de bord.

Examiner une utilisation que vous ne reconnaissez pas

Si Utilisation affiche une activité que vous ne pouvez pas associer à des requêtes dans les journaux de votre application, effectuez ces vérifications :

  1. Vérifiez l’organisation, le périmètre des projets et la période de rapport. Utilisez l’heure UTC pour comparer les horodatages du tableau de bord avec les journaux de votre application.

  2. Utilisez la vue du projet concerné ou sélectionnez-le sous Projet dans Analyses de l’organisation. Utilisez ensuite Filtres pour affiner l’utilisation par clé API et par modèle, puis sélectionnez une période de rapport plus courte.

  3. Comparez l’activité avec les journaux correspondant à la même période, au même projet et à la même clé API. Vérifiez si vos journaux couvrent toutes les applications ou intégrations utilisant cette clé.

  4. Si plusieurs applications ou intégrations partagent le même projet ou la même clé API, le total seul peut ne pas suffire à identifier celle qui a envoyé une requête. Comparez le tableau de bord avec les enregistrements de chaque application pour la même période UTC.

  5. Si vous ne parvenez toujours pas à expliquer l’utilisation, contactez l’assistance OpenAI en fournissant la période UTC concernée, les identifiants de l’organisation et du projet, l’identifiant de la clé API, ainsi que les captures d’écran ou journaux pertinents. Joignez les identifiants des requêtes, si disponibles. Ne joignez pas de clés API secrètes.

Exporter les données d’utilisation

Pour exporter les données d’utilisation, sélectionnez l’icône Exporter en CSV dans la barre d’outils Analyses, puis sélectionnez Données d’activité.

  1. Sélectionnez la Fonctionnalité de l’API et une ou plusieurs dimensions dans Regrouper par.

  2. Vérifiez Source API, Projets, Utilisateurs, Clés API et Modèles. Projets et Source API sont présélectionnés à partir d’Analyses ; sélectionnez les autres filtres d’exportation dans la boîte de dialogue.

  3. Sélectionnez Format de fichier, Heure de début, Heure de fin et Intervalle de temps, puis sélectionnez Télécharger. Les dates incluent des journées UTC complètes.

Les données d’activité et de coûts peuvent être consultées et exportées depuis 00:00 UTC à la date d’il y a un an calendaire jusqu’à aujourd’hui. Pour des données plus anciennes, contactez l’assistance OpenAI. Les données quotidiennes sont exportées dans des fichiers couvrant des périodes de 31 jours.

Pour le rapprochement des factures mensuelles et les exportations par poste, consultez : Exporter les détails d’utilisation mensuelle.

Si une exportation d’activité contient des lignes négatives, comparez les lignes ayant la même unité, le même regroupement et les mêmes dates. Utilisez Données de coûts pour les montants facturés. Une ligne d’activité négative ne suffit pas à établir qu’un avoir a été appliqué à votre facture.

Consulter les dépenses

Ouvrez Analyses et sélectionnez Dépenses pour consulter les coûts du projet actuel. Pour les coûts à l’échelle de l’organisation, sélectionnez Analyses de l’organisation, puis Dépenses.

Vérifiez la plage de dates actuelle et les filtres avant de comparer les coûts avec l’utilisation. Utilisation et Dépenses proposent des filtres différents ; un filtre disponible dans un tableau de bord peut ne pas s’appliquer à l’autre.

Utilisez Sources API, Clés API, Modèles et Postes de facturation pour affiner les dépenses. Dans les analyses de l’organisation, utilisez Projet pour inclure les projets à examiner. Utilisez les onglets Postes de facturation, Clés API, Utilisateurs, Projets et Modèles du tableau pour consulter les répartitions disponibles.

Une valeur de plafond de dépenses indisponible ne signifie pas que votre plafond est nul ni qu’un nouveau plafond a été appliqué. Les autorisations d’accès, un plafond non défini ou l’échec d’une requête peuvent empêcher le tableau de bord d’afficher une valeur.

Consulter l’état du service

Si votre organisation a accès à État du service, ouvrez ce tableau de bord dans Analyses pour examiner les performances de l’API. Pour connaître les conditions d’éligibilité et la définition des indicateurs, consultez : Résoudre les problèmes d’erreurs et de latence de l’API.

Consulter les crédits accordés

Les détails des crédits accordés sont disponibles sur la page Facturation de votre organisation.

Les crédits accordés et l’utilisation de l’API répondent à des questions différentes : les crédits accordés indiquent les crédits associés à votre organisation, tandis que l’utilisation indique son activité 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 quota de l’offre Scale. Si toute l’utilisation de ce modèle reste dans le quota 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 reste imputé au niveau de l’organisation. Consultez les dépenses de l’ensemble de l’organisation plutôt que de vous fier à celles d’un seul projet.

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’organisation.

Si vous avez besoin de rapports consolidés, envisagez d’utiliser des projets au sein d’une seule organisation plutôt que des sous-organisations distinctes, ou utilisez l’API Usage pour une analyse personnalisée.

Vérifier l’utilisation des tokens dans une réponse API

Les noms des champs d’utilisation des tokens dépendent du point de terminaison.

Nombre de tokensChat CompletionsResponses
Tokens d’entréeusage.prompt_tokensusage.input_tokens
Tokens de sortieusage.completion_tokensusage.output_tokens
Total des tokensusage.total_tokensusage.total_tokens

Les réponses de Chat Completions peuvent inclure des informations sur l’utilisation des tokens. Voici quelques exemples :

{
"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 en cache et de tokens de raisonnement. Ces données aident à comprendre pourquoi la longueur visible d’une réponse ne reflète pas sa consommation totale de tokens.

Pour une explication des différentes catégories de tokens, consultez : Comprendre et compter les tokens.

Dans une réponse de transcription indiquant l’utilisation des tokens, les tokens d’entrée audio et texte sont déjà inclus dans input_tokens. N’ajoutez pas à nouveau ces composants au total des tokens d’entrée. Comparez output_tokens séparément.

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.

Cet article vous a-t-il été utile ?