跳转到主要内容
发送 X-Phaseo-Metadata 请求头,用 team=support 这样的键值对标签标记请求,然后按这些标签筛选支出和日志。当你需要比 API 密钥或应用更细的成本维度时,就使用标签。标签不会改变模型请求,也不会转发给提供商。
TypeScript 和 Python SDK 接受自定义请求头,因此你可以在客户端上一次性设置同一个请求头。 要根据请求内容自动打标签,请使用请求分类器。它们的回答会作为请求标签保存,筛选方式相同。

标签规则

键和值会去除首尾空白。格式错误的请求头、重复的键或违反这些规则的标签,都会让请求在调用任何模型之前失败,返回 400 validation_error,原因为 invalid_request_metadata。 不要在标签中放入提示词、机密信息、电子邮件地址或其他个人数据。

按标签筛选支出

向分析端点同时传入 label_key 和 label_value:
响应与未筛选的分析数据使用相同的分组支出格式,但只统计带有该确切标签对的请求。只发送两个参数中的一个会返回 400 invalid_request。
最后修改于 2026年11月5日