Saltar al contenido principal
Envía un encabezado X-Phaseo-Metadata para marcar una solicitud con etiquetas clave/valor, como team=support, y después filtra el gasto y los registros por esas etiquetas. Usa etiquetas cuando necesites una dimensión de coste más específica que una clave de API o una aplicación. No cambian la solicitud al modelo y no se reenvían a los proveedores.
Los SDK de TypeScript y Python aceptan encabezados personalizados, así que puedes configurar el mismo encabezado una sola vez en el cliente. Para etiquetar solicitudes automáticamente según su contenido, usa clasificadores de solicitudes. Sus respuestas se guardan como etiquetas de solicitud y se filtran de la misma forma.

Reglas de las etiquetas

Se eliminan los espacios al principio y al final de claves y valores. Un encabezado mal formado, una clave duplicada o una etiqueta que incumpla estas reglas hace que la solicitud falle con 400 validation_error, motivo invalid_request_metadata, antes de llamar a ningún modelo. No pongas prompts, secretos, direcciones de correo electrónico ni otros datos personales en las etiquetas.

Filtra el gasto por etiqueta

Pasa label_key y label_value al endpoint de analíticas:
La respuesta tiene el mismo formato de gasto agrupado que las analíticas sin filtrar, pero solo cuenta las solicitudes que llevan exactamente ese par de etiqueta. Si envías solo uno de los dos parámetros, se devuelve 400 invalid_request.
Última modificación el 5 de noviembre de 2026