Skip to main content
月次スペンドリミットは、BYOK モデルにどれだけ支出しているかを監視し、その支出があなたの設定した上限に近づくと組織の Owner に通知します。早期警告のシグナルであり、強制停止ではありません。
これは通知であって上限ではありません。Kodus は上限に達してもレビューをブロック・停止することは一切ありません。 100% を超えても、支出はプロバイダー側のアカウントで積み上がり続けます。支出を実際に止めるには、モデルプロバイダーのダッシュボード(OpenAI、Anthropic、Google など)でハードリミットを設定してください — それだけが強制力を持ちます。Kodus のリミットは、プロバイダー側の上限に不意打ちされないための事前通知だと考えてください。

何を計測するか

  • BYOK モデルのみ。 支出は Bring Your Own Key で設定したモデル — あなたがプロバイダーに直接支払っているキー — に対して計測されます。Kodus 側で動かしているモデルは対象外です。
  • 現在のレートで、モデルごとに算定。 各モデルのトークンは、そのモデルの現在のレートで算定されます。スナップショットはありません — モデルの価格が変わると(カタログ更新または手動編集)、そのモデルの月初来の使用量が新しいレートで再計算されます。別のモデルに切り替えても、以前使っていたモデルが再算定されることはありません。
  • 暦月ごと(UTC)。 期間は月の 1 日から翌月の 1 日までです。使用量は毎月初めに自動的に $0 にリセットされます — 手動でリセットするものはありません。
数値が Kodus の分だけを反映するように、Kodus に渡す API キーは Kodus 専用にすることをおすすめします。同じキーを他のツールでも使っていると、プロバイダー側の使用量 — およびそれに基づく見積り — は両者が混ざります。

設定方法

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

BYOK 設定を開く

app.kodus.io/organization/byok を開き、Monthly spend limit までスクロールします。(このセクションは BYOK モデルを 1 つ以上設定すると表示されます。)
2

モデルの価格を確認する

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

価格のないモデルを修正する

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

月次リミットを設定して有効化する

上限を米ドルで入力し、Enable spend alerts をオンにして Save spend limit をクリックします。

モデルの価格設定

Kodus は各モデルを公開の価格カタログで照会し、見つかった値を事前入力します(Catalog)。カタログが誤っている、またはモデルが載っていない場合は、正しいトークン単価を入力してください — バッジが Manual に変わり、あなたの値が使われます。
上書きしたモデルで Revert to catalog price をクリックします。入力欄がカタログ値に戻り、バッジも Catalog に戻ります。以降、そのモデルは再び最新のカタログ価格に追随します(固定スナップショットはありません)。
カスタムエンドポイント、セルフホストのモデル、カタログが未収載のモデルには自動価格がありません。追跡可能にするにはレートを手動で入力してください。それまではリミットを有効化できません。

アラート

有効化すると、Kodus はおよそ1 時間に 1 回、月初来の支出を確認し、各しきい値を超えるたびに、メールとアプリ内通知センターで組織の Owner に通知します: 各しきい値は月に最大 1 回しか発火しないため、同じレベルで繰り返し通知されることはありません。新しい月が始まると自動的にリセットされます。
その間ずっとレビューは通常どおり実行されます — 50% でも、100% でも、それを超えても。起きるのはアラートだけです。
通知の送信先(およびどのロールが受け取るか)は、通知設定Spend Limit で管理できます。

精度について

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

価格を正確に保つ

カタログ価格をプロバイダーの価格ページと突き合わせ、ずれているものは修正してください。特にサブスクリプションや定額プランは、トークン単価ベースのカタログ価格とは一致しません。

キーは Kodus 専用にする

専用キーにすれば、Kodus が見る使用量は Kodus が発生させた使用量そのものになり、他の要因で数値が膨らみません。
同時実行のレビューで一時的に上限を超えることがあります。 上限付近で多数の PR が同時にレビューされると、次の 1 時間ごとのチェックが検知する前に、月初来の支出が 100% をやや超えることがあります。これは想定内です — 本当の上限をプロバイダー側に置くべきもう 1 つの理由です。

よくある質問

いいえ。通知のみです。支出を止めるには、モデルプロバイダーの請求ダッシュボードでハードリミットを設定してください。
BYOK モデルのトークン使用量のみで、BYOK 画面に表示されている現在のレートで算定されます。Kodus がホストするモデルは計上されません。
暦月の 1 日(UTC)です。月初来の支出が $0 に戻り、すべてのしきい値アラートが自動的に再武装されます。
いいえ。支出はモデルごとに追跡され、各モデルのトークンはそのモデルのレートで算定されます。モデル A に $50 使ってからモデル B に切り替えても、モデル A の使用量は $50 のままです — B に切り替えても A のトークンが B のレートで再算定されることはありません。合計は、その後 B が使った分だけ増えます。すでに発生した使用量が再算定されるのは、同じモデルの価格が変わったときだけです — 価格カタログがそのモデルのレートを更新したとき、または BYOK 画面で手動価格を編集したときに、そのモデルの月初来の使用量が新しいレートで再計算されます(固定スナップショットはありません)。
設定済みのすべてのモデルに価格(カタログまたは手動)が必要で、月次リミットは $0 より大きい必要があります。No price のモデルを修正し、正の金額を設定して保存してください。
組織の Owner が、アプリ内の通知センターで受け取ります。送信先は通知設定の Spend Limit で調整できます。