Nutzung und Kosten exportieren
Mit List Generation Costs rufst du die Kosten deiner Generierungen für einen Zeitraum ab, etwa für einen täglichen Import in ein Data Warehouse. Der Endpunkt liefert einen Eintrag pro abgeschlossener Generierung und bis zu 500 Einträge pro Aufruf. Für einen Tag mit 8,000 Generierungen brauchst du daher 16 Anfragen.
Verwende Get Generation Costs, um die Kosten einer einzelnen Generierung abzurufen. Beide Endpunkte liefern dasselbe Kostenobjekt.
Einen Zeitraum abfragen
Sende startTime und endTime als UTC-Zeitstempel nach ISO 8601. Der Zeitraum filtert nach dem Zeitpunkt, zu dem eine Generierung abgeschlossen wurde. startTime ist inklusive und endTime exklusive.
Mit einem API-Schlüssel kannst du alle Generierungen seiner Organisation auflisten. Es spielt keine Rolle, welcher Schlüssel oder welches Studio-Mitglied sie erstellt hat.
Alle Seiten abrufen
Die Antwort lautet { "items": [...], "nextCursor": "..." }. Fordere mit denselben Werten für startTime und endTime sowie mit cursor die nächste Seite an, bis nextCursor den Wert null hat. Die ältesten Einträge stehen zuerst.
Lass startTime und endTime beim Abrufen weiterer Seiten unverändert. Der Cursor setzt bei einer Generierung innerhalb des Zeitraums an. Wenn du den Zeitraum zwischen Seiten änderst, kannst du Einträge überspringen. Wenn der Cursor nicht auf eine Generierung im angefragten Zeitraum verweist, meldet die API 400. So lässt sich der Fehler vom Ende der Liste unterscheiden.
Angaben pro Eintrag
Beträge sind Zeichenfolgen mit fünf Dezimalstellen. Lies sie als Dezimalzahlen ein und vermeide Gleitkommazahlen. Eine Generierung mit Dubbing oder erzeugter Sprache enthält eine Komponente pro Bestandteil.
Einen täglichen Abruf einrichten
- Verwende lückenlos aufeinanderfolgende Zeiträume. Jede Generierung erscheint genau in dem Zeitraum, in dem sie abgeschlossen wurde. Wenn du zum Beispiel einen Zeitraum pro UTC-Tag verwendest, überschneiden sich die Zeiträume nie und keine Generierung wird übersprungen.
- Warte nach dem Ende des Zeitraums 10 Minuten. Kosten werden normalerweise innerhalb von etwa 10 Minuten nach Abschluss erfasst. Davor kann ein Eintrag
availability: "pending"haben. Rufe den Zeitraum später erneut ab, um inzwischen erfasste Beträge zu übernehmen. - Verwende
generationIdals Zeilenschlüssel. Ein erneuter Abruf desselben Zeitraums liefert dieselben Generierungen. Füge neue Zeilen ein und aktualisiere bestehende, damit deine Tabelle korrekt bleibt. - Behandle
nullals unbekannten Wert.totalCostUsdistnull, sofern nicht alle Kostenbestandteile bekannt sind.knownSubtotalUsdenthält den bekannten Teil. Siehe Verfügbarkeit. - Die Liste enthält nur abgeschlossene Generierungen. Eine laufende Generierung erscheint im Zeitraum, in dem sie abgeschlossen wird.
Verfügbarkeit
availability gibt an, wie viel von den Kosten eines Eintrags bekannt ist. status und reason der einzelnen Komponenten geben an, warum ein Betrag fehlt.
Bei einer Komponente mit pending liegt der Betrag meist innerhalb von etwa 10 Minuten vor. Es gibt jedoch keine Garantie, dass der Eintrag complete wird. Einträge mit partial oder unavailable können diesen Status behalten.
Bei Credit-Tarifen entsprechen die Beträge dem Nennwert von $0.01 pro Credit. Dieser Wert kann vom tatsächlich gezahlten Preis abweichen. Steuern, Abogebühren, Erstattungen, Kontoguthaben und Gebühren externer Anbieter sind in den Beträgen nicht enthalten.
Fehler behandeln
Jede Anfrage liest Daten. Du kannst den Abruf jeder Seite gefahrlos wiederholen.

