組織
組織は課金テナントです。独自のウォレット、独自の API キー、独自の使用台帳を所有します。組織のメンバーはゲートウェイを呼び出し、それらの呼び出しを個人のウォレットではなく組織のウォレットに帰属させることができます。
組織の作成
ダッシュボード → Organizations → Create。ユニークなスラグを選択します（URL に使用されます）。作成者がデフォルトでオーナーになります。
帰属
呼び出しが組織に帰属される方法は2つあります：
- 組織所有の API キー — 組織内で作成されたキーはすべての呼び出しを自動帰属。ヘッダー不要。
- 個人キー +
X-DeepToken-Orgヘッダー — 組織スラグを渡します。呼び出し元はメンバーである必要があります。
Authorization: Bearer dtk_...
X-DeepToken-Org: my-org-slug
ウォレットモード
各組織は2つのモードのいずれかを選択します：
- 厳格 — 組織ウォレットがゼロになると
402 org_wallet_emptyを返します。個人ウォレットには課金されません。 - フォールバック — 組織ウォレットが空の場合、呼び出し元の個人ウォレットが請求を引き受けます。暴走メンバーからの超過を吸収したいトライアルフローに便利です。
モードは組織設定ページからリアルタイムで切り替わります。新しい呼び出しはすぐに新しいモードに適用されます。
メンバーとロール
- オーナー — 完全な制御権。退任前に所有権を移譲してください。
- 管理者 — メンバー、API キー、課金を管理。組織の削除は不可。
- メンバー — 呼び出しの実行；自身の使用状況の表示。
- ビューアー — ダッシュボードと監査ログへの読み取り専用アクセス。
すべてのメンバーシップ変更は監査行に書き込まれます。