environment タグで区別します：
各キーにスタンプする短い自由形式ラベルで、コンソール、チーム、そして Usage Tracking タブが、
キーをそれが実行される場所でグループ化できるようにします。
これは小さな組織化フィールドであり、強制フィールドではありません — キーができることを変えません。
キーを境界づける制限（モデル、IP、支出、失効、ポリシー）については、
スコープ付きキー概要から始めてください。
1. なぜ API キー環境タグなのか
リスト内のすべてのキーがsk-orca-•••• に見えるとき、本番キーと使い捨ての開発キーを区別
できません — そしてそれこそ、誤ってローテーション、取り消し、あるいは支出上限引き上げを
したくないキーです。environment タグは、匿名の資格情報をラベル付きのものに変えます：
- 一目で — キーリストはどのキーが
prod、staging、devかを表示するため、正しいものに 対して行動できます。 - 支出で — Usage Tracking タブは環境ごとに支出を折りたためるため、「今週ステージングは いくらかかっているか」がスプレッドシートではなく 1 つのフィルタになります。
- 慣習で — ワークスペース全体での共有された語彙（
prod/staging/dev）により、 リストを読むチームメイトが尋ねずにあなたのレイアウトを理解します。
タグは自由形式で記述的なだけです。モデル、IP、支出、ポリシーをゲートしません — それらは
他のキーフィールドです。
prod とタグ付けされた 2 つのキーは、
ラベルを共有する以上の特別な扱いを受けません。2. フィールドが受け付けるもの
environment はキーオブジェクト上の任意の短いテキストラベルです：
| プロパティ | 挙動 |
|---|---|
| 型 | 自由形式の文字列 — 固定 enum なし。prod、staging、dev は慣習であり、組み込み値ではありません。 |
| 長さ | 周囲の空白を除去し、32 文字にクランプ；それより長いものは切り詰められます。 |
| 空 / 未設定 | タグのないキーはラベルなし状態として読み戻され、Usage Tracking で unlabeled セグメントに折りたたまれます。 |
| トラフィックへの影響 | なし — 純粋に組織化目的。 |
3. キーにタグを設定する
environment を、モデル制限とポリシーアタッチメントを設定するのと同じ場所、コンソールの
キーエディタ（/console/token）で設定します。キーの作成または編集には Developer ロール
以上が必要です。
4. 環境ごとに支出をセグメント化する
キーがタグ付けされると、Usage Tracking タブ（コンソール → Overview）は支出、リクエスト、 トークンを environment ディメンションでグループ化できます。すべてのキーの使用量をその 環境ラベルの下に折りたたみ、タグのないキーはunlabeled の下にまとめます。それは、実際に
予算を立てるレベルで、キーごとのビューが答えられない問いに答えます：
- 今週
stagingはprodに対していくら費やしているか？ - 新しい
devキーは予想を超えて膨れ上がったか？ - 火曜日のスパイクをどの環境が引き起こしたか？
environment ディメンションは、レポートをロードするときに各キー上の現在のラベルを読みます。
キーを再タグ付けすると、次にビューを開いたときにその過去の支出がどう折りたたまれるかが変わり
ます — タグはキーのライブプロパティであり、過去のリクエストに凍結されたスタンプではありません。
5. 実践例：3 つのキー、1 つのワークスペース
3 つの環境にわたって 1 つのプロダクトを運用する小さなチーム：| キー | environment | 他のスコープ（実際に強制する部分） |
|---|---|---|
| 本番エージェント | prod | 厳しい firewall_policy_id、週次の credit_limit_usd、固定された allow_ips |
| ステージングエージェント | staging | シャドウモードの寛容なファイアウォールポリシー、より低い上限 |
| ローカル開発 | dev | 1 つの安価なモデルへの model_limits、近い expired_time |
prod キーを
ローテーションするときに正しいものを掴んだと確信できます。
6. タグ vs 強制 — 2 つを混同しない
environment タグは、キー上の最も軽いフィールドです。それをセキュリティコントロールとして 手に取りやすいですが、それはコントロールではありません。dev キーに本番モデルを叩いたり
本物のお金を費やしたりすることをできなくさせたいなら、ラベルはそれをしません — 強制
フィールドがします：
モデル制限
model_limits が、dev タグではなく、開発キーがフロンティアモデルを呼ぶのを実際に
止めるものです。クォータ、上限、失効
credit_limit_usd と expired_time が支出と寿命を境界づけます。タグは整理し、これらは
制約します。ポリシーをバインド
guardrail_id と firewall_policy_id が、キーのトラフィックを統制するコンテンツと
ツール呼び出しのポリシーをアタッチします。トークンオブジェクト
environment タグを含む、キーのフィールドごとの完全なリファレンス。
7. これがどこにフィットするか
environment タグは、より広範なキーモデルの 1 スライスです — すべてのエージェントとそれが 実行されるすべての場所のための、狭くラベル付きのアイデンティティ。スコープ付きキー概要
キーが運ぶすべてのフィールドのハブ。
スコープとキー
ワークスペース、ポリシー、キーがどのように入れ子になるか。
キーを管理
コンソールでキーを作成、編集、取り消し。