Zum Hauptinhalt springen
Gute TokenLab-Observierbarkeit beginnt mit öffentlichen Identifikatoren. Ihre Protokolle sollten Ihnen helfen, die Fragen “Was hat der Benutzer angefordert, welche öffentliche Aufgabe hat TokenLab erstellt und wie wurde sie abgerechnet?” zu beantworten, ohne interne Routing-Details des Anbieters oder sensible Benutzerdaten offenzulegen.

​
Öffentliche Identifikatoren Zum Erfassen

IdentifikatorWo er erscheintVerwendung
request_idFehlertexte, Dashboard-Protokolle, NutzungsaufzeichnungenUnterstützung und Abgleich auf Anfrageebene
id / task_idAsynchrone Erstellungs- und StatusantwortenAbfragen von Bild-, Video-, Musik- und 3D-Jobs
poll_urlAntworten auf asynchrone ErstellungenBevorzugte Status-URL
billing_transaction_idNicht-Streaming-Antworten, wenn abgerechnet, asynchrone Aufgabenstatusantworten, Nutzungsaufzeichnungen, X-Billing-Transaction-IDKostenabgleich
X-Task-IDHeader von asynchronen AufgabenantwortenHeader-Level-Aufgaben-Korrelation
Ihre eigene Job-/Benutzer-IDIhre AnwendungVerknüpfung der TokenLab-Aktivität mit dem Benutzer-Workflow
Speichern Sie keine Anbieter-Aufgaben-IDs, upstream-URLs, Routing-Kanal-IDs, Redis-Schlüssel oder private Ausführungsmetadaten als kundenorientierte Wahrheit.

​
Was Zu Protokollieren Ist

Protokollieren Sie genug, um die Anfrage zu diagnostizieren, ohne Geheimnisse preiszugeben:
  • Endpunkt, HTTP-Methode, Modell, Statuscode, Zeitstempel und Latenz.
  • Öffentliche Identifikatoren: request_id, task_id, poll_url und billing_transaction_id, wenn vorhanden.
  • Sanitärisierte Anfrageform: welche Felder vorhanden waren, nicht das vollständige Prompt oder private Medieninhalte.
  • Terminal asynchrone Statusantworten, einschließlich öffentlicher Fehlerfelder.
  • Client-Wiederholungsanzahl und ob die Wiederholung eine neue Aufgabe erstellt oder eine bestehende fortgesetzt hat.
Redigieren Sie immer Authorization, API-Schlüssel, Verwaltungstoken, signierte URLs, private Medien-URLs, vollständige Prompts und persönliche Benutzerdaten, es sei denn, Sie haben ausdrückliche Erlaubnis, diese zu behalten.

​
Fehlersuche-Matrix

SymptomErste ÜberprüfungNützliche Seite
401 oder 403API-Schlüssel, Verwaltungstoken, Organisationszugriff, SchlüsselbereichAuthentifizierung
402Guthaben, Ausgabenlimit des API-Schlüssels, Verfügbarkeit des ModellpreisesAbrechnung & Preisgestaltung
429Kontostufe, Endpunkt-Rate-Limit, WiederholverhaltenRate Limits
400 invalid_request_errorNicht unterstütztes Feld, falscher Endpunkt, fehlendes erforderliches Feld oder ModellvertragsabweichungFehlerbehandlung
Asynchrone Aufgabe kann nicht gefunden werdenFalscher API-Schlüssel, veraltete Aufgaben-ID, abgelaufene Aufgabe oder nicht-öffentliche Aufgaben-IDAsynchrone Jobs & Abfragen
Kosten stimmen nicht mit der UI übereinAbrechnungszeitpunkt oder Vergleich des falschen IdentifikatorsAbrechnung & Preisgestaltung

​
Nutzungskontrolle

Verwenden Sie die Management-API für serverseitige Abgleiche: 
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"
GET /v1/management/api-keys/{keyId}/usage kann nach scene, accessChannel, logicalModel, modelVendor, startDate und endDate filtern. Verwenden Sie diese Aufzeichnungen anstelle von Scraping-Dashboard-Seiten oder der Abhängigkeit von upstream-Anbieter-Aufgaben-IDs. Streaming-Antworten können nach dem Senden des Streams abgerechnet werden, sodass ein Abrechnungsheader fehlen kann, selbst wenn die Nutzung später aufgezeichnet wird. Asynchrone Medienaufgaben können nach terminalen Abfragen abgerechnet werden.

​
Support-Paketvorlage

Beim Kontakt mit dem Support sollten Sie Folgendes einfügen:
  • request_id.
  • task_id und poll_url für asynchrone Arbeiten.
  • billing_transaction_id, wenn vorhanden.
  • Endpunkt, Methode, Modell, Zeitstempel und Statuscode.
  • Sanitärisierte Anfrageform und öffentlicher Fehlertext.
  • Ihr erwartetes Ergebnis und was der Benutzer tatsächlich gesehen hat.
Schließen Sie keine API-Schlüssel, Verwaltungstoken, private Medien, vollständige Prompts, Anbieter-URLs, Kanal-IDs oder interne Routing-Identifikatoren ein, es sei denn, der TokenLab-Support fordert ausdrücklich ein redigiertes Beispiel an.

​
Betriebliche Überprüfungen

  • Alarmieren Sie bei wiederholten 401, 402, 429 und 5xx-Antworten separat; sie haben normalerweise unterschiedliche Verantwortliche.
  • Verfolgen Sie asynchrone Jobs, die länger als Ihre Produkt-SLA nicht-terminal bleiben.
  • Verfolgen Sie doppelte Erstellungsversuche für dieselbe Benutzer-Job-ID.
  • Proben Sie abgeschlossene Jobs und überprüfen Sie, ob das benutzerseitig sichtbare Asset, die Nutzungsaufzeichnung und der gespeicherte Aufgabenaufzeichnung übereinstimmen.

​
API-Referenz

ThemaReferenz
FehlerbehandlungFehlerbehandlung
Rate LimitsRate Limits
Abrechnung & PreisgestaltungAbrechnung & Preisgestaltung
API-Schlüssel-Nutzung abrufenAPI-Schlüssel-Nutzung abrufen
Aufgabenstatus abrufenAufgabenstatus abrufen