Utilisez des libellés de requête lorsque le code de l’application a besoin d’une dimension de coût stable, plus précise qu’une clé API ou qu’une application. Les libellés sont enregistrés avec l’audit de la requête et peuvent être filtrés dans les analyses sans modifier la requête au modèle.
Envoyer des libellés
Définissez X-Phaseo-Metadata comme un objet JSON contenant jusqu’à 32 paires clé-valeur uniques :
Les SDK TypeScript et Python acceptent les en-têtes personnalisés ; vous pouvez donc configurer le même en-tête sur le client. Les libellés ne sont pas transmis aux fournisseurs.
Ventiler les dépenses
Utilisez le point de terminaison des analyses avec label_key et label_value :
La réponse conserve le même format de dépenses regroupées que les analyses non filtrées, mais n’inclut que les requêtes portant exactement cette paire de libellés.
Règles
- Les clés ne peuvent contenir que des lettres, des chiffres,
_, ., : ou -, et sont limitées à 64 caractères.
- Les valeurs sont des chaînes limitées à 256 caractères.
- Une requête peut contenir jusqu’à 32 libellés et l’en-tête est limité à 8 Kio.
- Les clés en double ou les métadonnées mal formées sont rejetées avec
400 invalid_request.
- Ne placez pas de prompts, de secrets, d’adresses e-mail ni d’autres données personnelles dans les libellés.
Dernière modification le 2 octobre 2026
