Zum Hauptinhalt springen
Sende einen X-Phaseo-Metadata-Header, um eine Anfrage mit Schlüssel-Wert-Labels wie team=support zu kennzeichnen, und filtere dann Ausgaben und Protokolle nach diesen Labels. Verwende Labels, wenn du eine Kostendimension brauchst, die feiner ist als ein API-Schlüssel oder eine App. Sie ändern die Modellanfrage nicht und werden nicht an Anbieter weitergeleitet.
Die TypeScript- und Python-SDKs akzeptieren benutzerdefinierte Header, sodass du denselben Header einmal am Client setzen kannst. Um Anfragen automatisch anhand ihres Inhalts zu kennzeichnen, verwende Anfrage-Klassifikatoren. Ihre Antworten werden als Anfragekennzeichnungen gespeichert und lassen sich genauso filtern.

Regeln für Labels

Schlüssel und Werte werden getrimmt. Ein fehlerhafter Header, ein doppelter Schlüssel oder ein Label, das gegen diese Regeln verstößt, lässt die Anfrage mit 400 validation_error und dem Grund invalid_request_metadata fehlschlagen, bevor ein Modell aufgerufen wird. Speichere keine Prompts, Geheimnisse, E-Mail-Adressen oder andere personenbezogene Daten in Labels.

Ausgaben nach Label filtern

Übergib sowohl label_key als auch label_value an den Analytics-Endpunkt:
Die Antwort hat dasselbe gruppierte Ausgabenformat wie ungefilterte Analysen, zählt aber nur Anfragen mit genau diesem Label-Paar. Wird nur einer der beiden Parameter gesendet, kommt 400 invalid_request zurück.
Zuletzt geändert am 5. November 2026