Zum Hauptinhalt springen
Fragen Sie mit Ihrem API Key die Abbuchung jedes Aufrufs sowie den tatsächlichen Preis ab, den Ihr Konto für ein Modell zahlt. Keiner der drei Endpunkte prüft das Guthaben; sie funktionieren auch bei einem Guthaben von 0.

Authentifizierung

string
erforderlich
Verwenden Sie denselben API Key wie für Modellaufrufe mit Bearer-Token-Authentifizierung. Ihren Schlüssel erhalten Sie auf der API-Key-Verwaltungsseite.

Endpunkte

Beträge sind in USD; cost_credits und credits sind Credits und entsprechen USD × 10.

Einzeleintrag per Request-ID abfragen

string
erforderlich
  • Synchrone Aufrufe: Wert des Antwort-Headers X-Oneapi-Request-Id
  • Asynchrone Aufgaben: die beim Absenden zurückgegebene Task-ID
Logs werden asynchron geschrieben und sind meist wenige Sekunden nach Ende der Anfrage abrufbar. Bei 404 log_not_found versuchen Sie es später erneut. Asynchrone Aufgaben müssen per Task-ID abgefragt werden und haben erst nach Abschluss oder Fehlschlag einen Eintrag.
Die Abfrage umfasst das gesamte Konto, dem der API Key gehört. data ist ein Array; dieselbe ID kann sowohl einen Verbrauchs- als auch einen Fehlereintrag haben. Wichtigste Felder: cost_usd ist der endgültig abgerechnete Betrag: Fehlereinträge sind immer 0, Erstattungen bei Fehlschlägen sind vor dem Schreiben des Eintrags abgeschlossen. Die Summe der Einträge mit type = consume ergibt die Abbuchungen für Ihre Aufrufe.

Request-Logs synchronisieren

Rufen Sie alle Einträge Ihres Kontos in einem Zeitraum seitenweise ab – ideal für den regelmäßigen Abgleich. Die Felder entsprechen denen der Einzelabfrage.
integer
erforderlich
Startzeit, Unix-Zeitstempel in Sekunden.
integer
Endzeit, Unix-Zeitstempel in Sekunden. Standard ist die aktuelle Zeit. Beide Grenzen sind inklusive, der Zeitraum darf 31 Tage nicht überschreiten.
string
Standard:"all"
Eintragstyp: all, consume oder error.
string
Nach Modellname filtern.
integer
Nur Einträge des angegebenen API Keys zurückgeben. Die ID können Sie in der Konsole in der Liste „API-Schlüssel“ kopieren (unter dem Schlüsselnamen angezeigt); nach dem Rotieren des Schlüssels bleibt die ID gleich.
integer
Standard:"100"
Seitengröße, 1–1000.
string
Paginierungs-Cursor. Übergeben Sie den next_cursor der vorherigen Seite unverändert und lassen Sie die übrigen Parameter beim Blättern gleich.
In der Antwort gibt has_more an, ob es eine weitere Seite gibt, next_cursor ist der Cursor für die nächste Seite und watermark die Serverzeit minus 300 Sekunden.
Empfohlenes Synchronisierungsmuster: end_timestamp jedes Laufs nicht später als watermark; den nächsten Lauf 10 Minuten vor dem Ende des vorherigen beginnen und nach (id, type) deduplizieren; innerhalb eines Zeitfensters blättern, bis has_more false ist.

Kontopreis abfragen

Fragen Sie den tatsächlichen Preis ab, den das Konto des aktuellen API Keys für ein Modell zahlt. Individuelle Preise, Mitgliederpreise, Gruppenfaktor und Rabatte sind berücksichtigt – genau wie bei der Abbuchung beim Aufruf. Die Preisseite zeigt öffentliche Preise; für Schätzungen für Ihr eigenes Konto verwenden Sie diesen Endpunkt.
string
erforderlich
Modellname; Aliase werden unterstützt.
string
Auflösung oder Stufe; muss vom Modell unterstützt werden.
string
Bildgröße.
string
Qualitätsstufe.
integer
Dauer in Sekunden, 1–3600, für sekundenbasierte Modelle.
integer
Anzahl der Ausgaben, 1–100.
Ohne Spezifikationsparameter wird die Standardspezifikation des Modells bepreist. Bei sekundenbasierten Modellen ohne duration wird nur der Preis pro Sekunde zurückgegeben. Wichtigste Antwortfelder: Bis zu 60 Abfragen pro Minute und API Key.

Fehlerbehandlung