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 consulter un projet, plusieurs projets ou tous les projets. Pour voir les données globales de l’organisation, désélectionnez tous les projets. Lorsqu’aucun projet n’est sélectionné, le tableau de bord affiche les données de tous les projets.
Si plusieurs applications utilisent le même projet ou la même clé API, un total pour ce projet ou cette clé ne permet pas de déterminer quelle application a effectué une requête. Comparez vos propres enregistrements de requêtes pour la même période en UTC.
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 soumise à aucune limite. Les exportations couvrant une longue période peuvent être réparties dans plusieurs fichiers.
Pour le rapprochement des factures mensuelles et les exportations par poste, consultez : Exporter les détails d’utilisation mensuelle.
Si une exportation d’activité comprend des lignes négatives, comparez les lignes ayant la même unité, le même regroupement et les mêmes dates. Utilisez les données de coût pour connaître les montants facturés. Une ligne d’activité négative ne suffit pas à établir qu’un crédit a été appliqué à votre facture.
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 |
| 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 à expliquer 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.
Dans une réponse de transcription indiquant l’utilisation de tokens, les tokens d’entrée audio et texte sont déjà inclus dans input_tokens. N’ajoutez pas de nouveau ces composantes au total des tokens d’entrée. Comparez output_tokens séparément.
Obtenir les données d’utilisation de Chat Completions en continu
Pour une requête Chat Completions en continu, incluez :
{
"stream": true,
"stream_options": {
"include_usage": true
}
}Lorsque include_usage est activé, un bloc supplémentaire avant data: [DONE] contient les données d’utilisation pour l’ensemble de la requête. Son tableau choices est vide. Dans les autres blocs, la valeur de usage est null.
Si le flux est interrompu, il se peut que vous ne receviez pas ce dernier bloc de données d’utilisation. L’absence du dernier bloc ne permet pas de conclure 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.