Exporter l’utilisation et les coûts
Utilisez Lister les coûts des générations pour récupérer le coût de vos générations sur une période, par exemple pour alimenter chaque jour un entrepôt de données. L’API renvoie un élément par génération terminée et jusqu’à 500 par appel. Il faut donc 16 requêtes pour une journée de 8,000 générations.
Pour connaître le coût d’une seule génération, utilisez Récupérer les coûts d’une génération. Les deux points de terminaison renvoient le même objet de coût.
Interroger une période
Envoyez startTime et endTime sous forme de dates et heures UTC au format ISO 8601. Le filtre porte sur la date de fin de la génération. La borne startTime est incluse et la borne endTime est exclue.
Une clé API permet de lister toutes les générations de son organisation, quelle que soit la clé ou la personne qui les a créées dans Studio.
Lire toutes les pages
La réponse est { "items": [...], "nextCursor": "..." }. Demandez la page suivante avec les mêmes valeurs de startTime et endTime, ainsi que cursor, jusqu’à ce que nextCursor vaille null. Les éléments sont triés du plus ancien au plus récent.
Conservez les valeurs de startTime et endTime pendant la pagination. Le curseur reprend à partir d’une génération de la période. Changer de période entre deux pages peut donc omettre des éléments. Si le curseur ne correspond à aucune génération de la période demandée, l’API renvoie 400 pour distinguer cette erreur de la fin des données.
Contenu de chaque élément
Les montants sont des chaînes représentant des nombres à cinq décimales. Analysez-les comme des nombres décimaux et excluez les nombres à virgule flottante. Une génération avec doublage ou synthèse vocale contient une composante pour chaque prestation.
Mettre en place un export quotidien
- Utilisez des périodes consécutives. Une génération apparaît dans une seule période, celle où elle s’est terminée. Les périodes définies par jour UTC, par exemple, ne se chevauchent pas et n’omettent aucune génération.
- Attendez 10 minutes après la fin de la période. L’enregistrement des coûts prend généralement environ 10 minutes après la fin de la génération. Avant cela, un élément peut avoir
availability: "pending". Interrogez à nouveau la période plus tard pour récupérer les montants enregistrés depuis. - Utilisez
generationIdcomme clé de ligne. Relire une période renvoie les mêmes générations. Insérez ou mettez à jour les lignes selon leur clé pour garder votre table à jour. - Interprétez
nullcomme un montant inconnu.totalCostUsdvautnulltant que toutes les composantes du coût ne sont pas connues.knownSubtotalUsdindique la part connue. Consultez Disponibilité. - La liste contient uniquement les générations terminées. Une génération en cours apparaît dans la période où elle se termine.
Disponibilité
availability indique la part connue du coût d’un élément. Les champs status et reason de chaque composante indiquent pourquoi un montant manque.
Le montant d’une composante pending est généralement renseigné dans un délai d’environ 10 minutes. Rien ne garantit qu’un élément passera à complete. Les éléments partial et unavailable peuvent conserver cet état.
Avec les forfaits à crédits, les montants correspondent à la valeur nominale de $0.01 par crédit. Cette valeur peut différer du prix payé. Les montants excluent les taxes, les frais d’abonnement, les remboursements, les avoirs et les frais des prestataires externes.
Gérer les erreurs
Toutes les requêtes sont en lecture seule. Vous pouvez donc réessayer de récupérer n’importe quelle page sans risque.

