Verwende Request-Labels, wenn der Anwendungscode eine stabile Kostenkategorie benötigt, die genauer ist als ein API-Schlüssel oder eine Anwendung. Labels werden mit dem Anfrage-Audit erfasst und lassen sich in Analysen filtern, ohne die Modellanfrage zu ändern.
Labels senden
Setze X-Phaseo-Metadata auf ein JSON-Objekt mit bis zu 32 eindeutigen Schlüssel-Wert-Labels:
Die TypeScript- und Python-SDKs akzeptieren benutzerdefinierte Header, sodass derselbe Header am Client konfiguriert werden kann. Labels werden nicht an Provider weitergeleitet.
Ausgaben aufschlüsseln
Verwende den Analytics-Endpunkt mit label_key und label_value:
Die Antwort verwendet dasselbe gruppierte Ausgabenformat wie ungefilterte Analysen, enthält aber nur Anfragen mit genau diesem Label-Paar.
Regeln
- Schlüssel dürfen Buchstaben, Zahlen,
_, ., : oder - enthalten und höchstens 64 Zeichen lang sein.
- Werte sind Strings mit höchstens 256 Zeichen.
- Eine Anfrage kann bis zu 32 Labels enthalten; der Header ist auf 8 KiB begrenzt.
- Doppelte Schlüssel oder fehlerhafte Metadaten werden mit
400 invalid_request abgelehnt.
- Speichere keine Prompts, Geheimnisse, E-Mail-Adressen oder andere personenbezogene Daten in Labels.
Zuletzt geändert am 2. Oktober 2026
