Pular para o conteúdo principal
Envie um cabeçalho X-Phaseo-Metadata para marcar uma solicitação com rótulos de chave/valor, como team=support, e depois filtre os gastos e os registros por esses rótulos. Use rótulos quando precisar de uma dimensão de custo mais detalhada que uma chave de API ou um aplicativo. Eles não alteram a solicitação ao modelo e não são repassados aos provedores.
Os SDKs de TypeScript e Python aceitam cabeçalhos personalizados, então você pode definir o mesmo cabeçalho uma única vez no cliente. Para rotular solicitações automaticamente pelo conteúdo, use os classificadores de solicitações. As respostas deles são armazenadas como rótulos de solicitação e são filtradas da mesma forma.

Regras dos rótulos

As chaves e os valores têm os espaços das extremidades removidos. Um cabeçalho malformado, uma chave duplicada ou um rótulo que viole essas regras faz a solicitação falhar com 400 validation_error, motivo invalid_request_metadata, antes de qualquer modelo ser chamado. Não coloque prompts, segredos, endereços de e-mail nem outros dados pessoais nos rótulos.

Filtrar gastos por rótulo

Passe label_key e label_value para o endpoint de análises:
A resposta tem o mesmo formato de gastos agrupados das análises sem filtro, mas conta apenas as solicitações que têm exatamente esse par de rótulo. Enviar apenas um dos dois parâmetros retorna 400 invalid_request.
Última modificação em 5 de novembro de 2026