組織
ai& はマルチテナント設計です。すべてのリクエストは 組織 のコンテキスト内で実行され、課金、API キー、レート制限、リクエスト履歴はすべて組織単位でスコープされます。
データモデル
Section titled “データモデル”- ユーザー — メールアドレスで識別される個人アカウント。初回 OAuth またはマジックリンクサインインで作成。
- 組織 — 課金とアクセスの境界。クレジット、API キー、ファイル、リクエストログを保有。
- メンバーシップ — ユーザーと組織を ロール (
owner、admin、member) で結びつけます。1 ユーザーが複数組織に所属可能。 - API キー — 組織レベルで発行。組織コンテキストを自動で保持するため、API キー認証時には
X-Org-IDは不要。 - 課金アカウント — 組織ごとに 1 つ。クレジット残高、支払い方法、請求履歴を保持。
- API キー認証 — キー自体に組織が紐づくため、すべての操作がそのキーの組織で行われます。
- JWT (ブラウザ) 認証 — 各リクエストで
X-Org-IDを指定して組織を選択します。組織の切り替え を参照。
組織ごとのスコープ
Section titled “組織ごとのスコープ”以下はすべて組織間で独立しています:
- クレジット残高と支払い方法
- API キー
- アップロード済みファイル
- リクエストログと分析データ
- レート制限のバケット (レート制限)