メインコンテンツへスキップ
X-Phaseo-Metadata ヘッダーを送信して、team=support のようなキーと値のラベルをリクエストに付け、そのラベルで支出とログを絞り込みます。API キーやアプリよりも細かいコストの切り口が必要なときにラベルを使います。ラベルはモデルへのリクエストを変更せず、プロバイダーにも転送されません。
TypeScript SDK と Python SDK はカスタムヘッダーを受け付けるため、同じヘッダーをクライアントで一度設定できます。 内容に基づいてリクエストに自動でラベルを付けるには、リクエスト分類器を使います。その回答はリクエストラベルとして保存され、同じ方法で絞り込めます。

ラベルのルール

キーと値の前後の空白は取り除かれます。ヘッダーの形式が不正な場合、キーが重複している場合、またはこれらのルールに違反するラベルがある場合、モデルが呼び出される前に、リクエストは 400 validation_error(理由 invalid_request_metadata)で失敗します。 プロンプト、シークレット、メールアドレス、その他の個人データをラベルに入れないでください。

ラベルで支出を絞り込む

分析エンドポイントに label_key と label_value の両方を渡します。
レスポンスはフィルターなしの分析と同じグループ化された支出形式ですが、そのラベルの組み合わせと完全に一致するリクエストだけを集計します。2 つのパラメーターの一方だけを送ると 400 invalid_request が返ります。
最終更新日 2026年11月5日