> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 月次スペンドリミット

> BYOK モデルの支出が月次の上限に近づいたら通知します。通知のみ — レビューは止まりません。

月次スペンドリミットは、**BYOK モデル**にどれだけ支出しているかを監視し、その支出があなたの設定した上限に近づくと組織の Owner に通知します。早期警告のシグナルであり、強制停止ではありません。

<Warning>
  **これは通知であって上限ではありません。Kodus は上限に達してもレビューをブロック・停止することは一切ありません。** 100% を超えても、支出はプロバイダー側のアカウントで積み上がり続けます。支出を実際に止めるには、**モデルプロバイダー**のダッシュボード（OpenAI、Anthropic、Google など）でハードリミットを設定してください — それだけが強制力を持ちます。Kodus のリミットは、プロバイダー側の上限に不意打ちされないための事前通知だと考えてください。
</Warning>

## 何を計測するか

* **BYOK モデルのみ。** 支出は [Bring Your Own Key](/how_to_use/ja/byok) で設定したモデル — あなたがプロバイダーに直接支払っているキー — に対して計測されます。Kodus 側で動かしているモデルは対象外です。
* **現在のレートで、モデルごとに算定。** 各モデルのトークンは、そのモデルの現在のレートで算定されます。スナップショットはありません — モデルの価格が変わると（カタログ更新または手動編集）、そのモデルの月初来の使用量が新しいレートで再計算されます。別のモデルに切り替えても、以前使っていたモデルが再算定されることはありません。
* **暦月ごと（UTC）。** 期間は月の 1 日から翌月の 1 日までです。使用量は毎月初めに自動的に \$0 にリセットされます — 手動でリセットするものはありません。

<Info>
  数値が Kodus の分だけを反映するように、**Kodus に渡す API キーは Kodus 専用にする**ことをおすすめします。同じキーを他のツールでも使っていると、プロバイダー側の使用量 — およびそれに基づく見積り — は両者が混ざります。
</Info>

## 設定方法

リミットは BYOK 画面の、Main と Fallback のモデルの下にあります。

<Steps>
  <Step title="BYOK 設定を開く">
    [app.kodus.io/organization/byok](https://app.kodus.io/organization/byok) を開き、**Monthly spend limit** までスクロールします。（このセクションは BYOK モデルを 1 つ以上設定すると表示されます。）
  </Step>

  <Step title="モデルの価格を確認する">
    設定済みの各モデルには、トークン単価 — **input、output、cache read、cache write** — が **\$ / 1M tokens** で表示されます。**Catalog** バッジは Kodus が価格を自動取得したことを、**Manual** バッジはあなたが自分で入力したことを意味します。
  </Step>

  <Step title="価格のないモデルを修正する">
    **No price** バッジが付いたモデルは自動で価格を判定できませんでした（カスタムモデルやカタログ未収載のモデル）。プロバイダーの価格ページを見てトークン単価を入力してください。すべてのモデルに価格が入るまでリミットは有効化できません — Kodus が価格を算定できないモデルの支出は追跡できないためです。
  </Step>

  <Step title="月次リミットを設定して有効化する">
    上限を米ドルで入力し、**Enable spend alerts** をオンにして **Save spend limit** をクリックします。
  </Step>
</Steps>

### モデルの価格設定

<AccordionGroup>
  <Accordion title="カタログ価格と手動価格">
    Kodus は各モデルを公開の価格カタログで照会し、見つかった値を事前入力します（**Catalog**）。カタログが誤っている、またはモデルが載っていない場合は、正しいトークン単価を入力してください — バッジが **Manual** に変わり、あなたの値が使われます。
  </Accordion>

  <Accordion title="手動価格をカタログ価格に戻す">
    上書きしたモデルで **Revert to catalog price** をクリックします。入力欄がカタログ値に戻り、バッジも **Catalog** に戻ります。以降、そのモデルは再び最新のカタログ価格に追随します（固定スナップショットはありません）。
  </Accordion>

  <Accordion title="モデルが 'No price' と表示される理由">
    カスタムエンドポイント、セルフホストのモデル、カタログが未収載のモデルには自動価格がありません。追跡可能にするにはレートを手動で入力してください。それまではリミットを有効化できません。
  </Accordion>
</AccordionGroup>

## アラート

有効化すると、Kodus はおよそ**1 時間に 1 回**、月初来の支出を確認し、各しきい値を超えるたびに、**メールとアプリ内通知センター**で組織の **Owner** に通知します：

| しきい値       | 内容                                           |
| ---------- | -------------------------------------------- |
| **50%**    | 事前アラート                                       |
| **75%**    | 事前アラート                                       |
| **90%**    | 事前アラート                                       |
| **100%**   | 「上限に到達」アラート                                  |
| **100% 超** | 「上限を超えました — 今月はこれ以上通知しません」という最終通知、以降その月は通知なし |

各しきい値は**月に最大 1 回**しか発火しないため、同じレベルで繰り返し通知されることはありません。新しい月が始まると自動的にリセットされます。

<Note>
  その間ずっとレビューは通常どおり実行されます — 50% でも、100% でも、それを超えても。起きるのはアラートだけです。
</Note>

通知の送信先（およびどのロールが受け取るか）は、[通知設定](https://app.kodus.io/organization/notifications) の **Spend Limit** で管理できます。

## 精度について

支出は**見積り**です。レビューが使用したトークンと、BYOK 画面に表示されているトークン単価から算出されるため、プロバイダーの請求書と 1 セント単位で一致することはありません。

<CardGroup cols={2}>
  <Card title="価格を正確に保つ" icon="tags">
    カタログ価格をプロバイダーの価格ページと突き合わせ、ずれているものは修正してください。特にサブスクリプションや定額プランは、トークン単価ベースのカタログ価格とは一致しません。
  </Card>

  <Card title="キーは Kodus 専用にする" icon="key">
    専用キーにすれば、Kodus が見る使用量は Kodus が発生させた使用量そのものになり、他の要因で数値が膨らみません。
  </Card>
</CardGroup>

<Warning>
  **同時実行のレビューで一時的に上限を超えることがあります。** 上限付近で多数の PR が同時にレビューされると、次の 1 時間ごとのチェックが検知する前に、月初来の支出が 100% をやや超えることがあります。これは想定内です — 本当の上限をプロバイダー側に置くべきもう 1 つの理由です。
</Warning>

## よくある質問

<AccordionGroup>
  <Accordion title="上限に達したらレビューは止まりますか？">
    いいえ。通知のみです。支出を止めるには、モデルプロバイダーの請求ダッシュボードでハードリミットを設定してください。
  </Accordion>

  <Accordion title="何が支出に計上されますか？">
    **BYOK** モデルのトークン使用量のみで、BYOK 画面に表示されている現在のレートで算定されます。Kodus がホストするモデルは計上されません。
  </Accordion>

  <Accordion title="支出はいつリセットされますか？">
    暦月の 1 日（UTC）です。月初来の支出が \$0 に戻り、すべてのしきい値アラートが自動的に再武装されます。
  </Accordion>

  <Accordion title="月の途中でモデルを切り替えました — 支出は跳ね上がりますか？">
    いいえ。支出は**モデルごと**に追跡され、各モデルのトークンは*そのモデルの*レートで算定されます。モデル A に \$50 使ってからモデル B に切り替えても、モデル A の使用量は \$50 のままです — B に切り替えても A のトークンが B のレートで再算定されることはありません。合計は、その後 B が使った分だけ増えます。

    すでに発生した使用量が再算定されるのは、**同じモデルの価格**が変わったときだけです — 価格カタログがそのモデルのレートを更新したとき、または BYOK 画面で手動価格を編集したときに、そのモデルの月初来の使用量が新しいレートで再計算されます（固定スナップショットはありません）。
  </Accordion>

  <Accordion title="なぜリミットを有効化できないのですか？">
    設定済みのすべてのモデルに価格（カタログまたは手動）が必要で、月次リミットは \$0 より大きい必要があります。**No price** のモデルを修正し、正の金額を設定して保存してください。
  </Accordion>

  <Accordion title="アラートは誰が受け取りますか？">
    組織の Owner が、アプリ内の通知センターで受け取ります。送信先は通知設定の **Spend Limit** で調整できます。
  </Accordion>
</AccordionGroup>