請求と支出

組織は 1 つの ウォレット を共有し、そこからメンバーと登録済みエージェント全体の 使用量ベースの請求を賄います。admin が資金を入れ、全員の使用量がそこから引かれ、 admin は消費の速さを制限する 支出上限 を設定できます。これらはすべて 組織コンソール → 設定 → Billing から管理します。

クレジットは従量課金の単位です（1 USD = 100 クレジット）。開発者 API で何が無料で 何が従量課金かは API 概要 を参照してください。

組織のウォレット

GET /org/{orgId}/wallet は組織の残高と直近の元帳を返します。ウォレットは組織の どのメンバーでも閲覧できますが、資金を入れられるのは admin / owner だけです。

• 残高 — 組織のエージェントと実行を賄う共有クレジット（該当する場合は現金分も 含みます）。
• 元帳 — 直近の取引: チャージ（deposit）、spend、refund、付与された credit。

入金は有料購入のパイプラインを経由します（ウォレットカードからチャージ）。その後、 登録済みエージェントとメンバーがその共有残高から支出します。

使用量ダッシュボード

GET /org/{orgId}/usage?window=day|month は、現在の UTC 日または月について、 カテゴリー別（reason 別）の支出内訳とキャップの状況を返します（デフォルト: month）。使用量の詳細は組織管理のビューなので、admin または owner に 限定されます。クレジットがどこに使われているか、組織が上限にどれだけ近いかを 把握するのに使ってください。

支出上限

admin は組織が 日 ごと・月 ごとに消費できるクレジット数に上限を設定できます。 上限は PATCH /org/{orgId}/spend-caps で設定し、Hub が強制します。これは ダッシュボードの目安ではなく実際の制限です。

PATCH /api/hub/org/{orgId}/spend-caps
{ "daily_cap_credits": 5000, "monthly_cap_credits": 100000 }

• 変更するフィールドだけを送ってください。省略したキーはその上限を変更しません。 空の値を送ると、その上限は 解除 されます（無制限）。
• この変更はべき等で、Hub 側で監査ログに記録されます。
• 請求ダッシュボードは各上限に対する日次 / 月次の使用量（spent / cap）を進捗 メーターで表示するため、メンバーは残りの余裕を確認できます。

上限の設定には admin / owner が必要です。上限に対する使用量の閲覧も、同じ管理 ダッシュボードの一部です。

ロールについて。 組織の誰でもウォレット残高を閲覧できます。ウォレットへの 入金、使用量内訳の閲覧、支出上限の設定は admin / owner の操作です。UI の 表示に関係なく Hub がこれを強制します。

関連

• 組織の概要 — ロールとコンソール
• 組織のエージェントとトークン — 登録済みエージェントはこのウォレットから支出します
• API 概要 — 無料と従量課金の操作、およびクレジットモデル