ガイド更新日：
公式 Account Billing API に基づき実装済みですが、実口座検証は未完了です。ログイン後の権限選択、キー作成、金額照合は未検証で、自動テストは実口座確認ではありません。
- 必要な認証情報
- fal API Key (key_id:key_secret)
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウント Credits 残高
- GET /v1/account/billing?expand=credits の credits.current_balance を currency=USD のまま表示します。セント換算や利用額の再控除はしません。チームキーは所属アカウントの共有 Credits を読み、モデル・キー・本站プロジェクトの個別残高ではありません。
fal.ai 残高を手動で確認するには？
- fal Dashboard にログインし、左上で支払い元の個人またはチームを選びます。
- Billing を開き、月額利用やモデル単価ではなく Credits を確認します。
- 必要なら公式で購入し反映を確認します。異なる個人・チーム口座は別々に調べます。
fal.ai を Quota Monitor に接続する
1. 実際に支払うアカウントを選ぶ
fal Dashboard にログインし、左上のアカウント名から支払い元の個人またはチームを選んで、下の Billing を開きます。監視のためだけにチームを新設する必要はありません。
確認：アカウント名と Credits が正しいこと。チームキー作成は既存の Admin に依頼し、自分の役割を安易に昇格させないでください。
2. 専用の監視キーを作成する
同じアカウントで API Keys を開き、Create Key を選び、名前を Quota Monitor にします。本番キーの使い回しや、次の権限設定を省略したキー作成 API の利用は避けます。
確認：アカウントとキー名を識別できること。旧 ADMIN/API scope しか見えない場合は fal や管理者に確認し、全権限キーを渡さないでください。
3. 請求の読み取り権限だけを残す
カスタム権限で不要項目を外し、billing:usage:read だけを残します。プリセットしか選べない場合は READONLY も対応しますが、リクエストやログ等も読み取れます。
確認：通常の API、FULL、旧 ADMIN は選ばないこと。BILLING も使えますが不要な権限を含みます。カスタム権限は固定で、プリセットは公式が変更する場合があります。ログイン後の手順は実検証待ちです。
4. 期限を設定し完全な秘密値を保存する
チーム方針に従って期限を設定し、作成を完了します。一度だけ表示される key_id:key_secret をパスワード管理ツールに保存してください。両方の値とコロンが必要です。
確認：Key や Bearer 接頭辞、引用符、空白、改行がないこと。チャット・画像・フィードバックに含めず、紛失時は再作成し、期限前に交換を計画します。
5. プロジェクトに fal.ai を追加する
Quota Monitor で対象プロジェクト → 接続追加 → 新規接続を開きます。fal.ai（USD）を選び、識別しやすい接続名を入力し、完全なキーをパスワード欄に貼り付けて保存します。
確認：API URL、チーム ID、供給元プロジェクト ID、Key ID は不要です。USD 固定、キーは暗号化され末尾4文字のみ表示します。MCP では安全な入力リンクを使い、秘密値を Agent に送らないでください。
6. 同期して Credits を照合する
初回同期を待つか最新残高照会を押し、成功時刻が更新されたら同じ fal アカウントの Billing と比較します。テスト時は秘匿済みの金額、口座選択、時刻だけを記録します。
確認：24.5 USD は $24.5 で、100 で割ったり月額利用を引いたりしません。実口座照合は未完了です。読み取りキーでモデルを呼べないのは正常で、推論権限を追加する理由にはなりません。
7. 必要なら公式で Credits を購入する
カードのプラットフォームを開く操作で Billing へ進み、アカウントを再確認します。必要な場合のみ支払い権限のある人が公式の購入手順を進めます。監視の接続自体に支払いや自動チャージは不要です。
確認：公式で入金が反映されてから再同期します。本站は請求 GET のみで、モデル実行、購入、返金、決済設定変更はしません。購入画面や最低額はログイン後の公式表示で確認してください。
8. 専用キーの交換と失効
同じ最小権限の新キーと代替接続を作り、同期を確認します。その後、旧接続の全プロジェクト参照を外して削除し、fal API Keys で旧専用キーを失効させます。接続枠がない場合は交換時間を計画してください。
確認：他の本番キーを変更・削除していないこと。プロジェクトから外すだけでは fal キーは失効しません。監視終了時は公式側でも専用キーを整理します。
Quota Monitor が取得する fal.ai のデータ範囲
- 認証されたアカウントのみを監視し、他の個人・チーム口座は合算しません。組織の共同請求も同じ口座で照合し、チームへの配分を推測しません。
- 現金・特典の内訳、有効期限、モデル別枠、リクエスト可否は取得しません。Credits を出金可能な現金とみなさないでください。
- 表示は最後に成功した公式照会結果です。observedAt は照会時刻で決済確定時刻ではありません。欠損・異通貨・失敗はゼロにせず、遅延ゼロも保証しません。
- 残高が正でもキー期限、権限、モデルや同時実行の制約は残ります。同じ財布を複数の接続で合算しないでください。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
fal.ai のよくある質問とトラブルシューティング
- 401 またはキー形式エラーになる？
- 完全な key_id:key_secret、コロン、期限、失効状態を確認し、Key/Bearer 接頭辞と改行を除きます。マスク値、Cookie、ログイン Bearer トークン、Key ID のみは使えません。紛失時は専用キーを再作成します。
- モデルは動くのに残高が 403 になる？
- API プリセットだけでは billing:usage:read がありません。正しいアカウントの既存管理者に単一権限のキーを依頼するか READONLY を確認します。FULL／旧 ADMIN で回避せず、続く場合は秘匿済み情報で fal に問い合わせます。
- 利用額と違う、または100倍ずれる？
- current_balance は残った Credits で、消費額ではありません。USD はドルのままです。口座と照会時刻を合わせてください。現金・特典内訳は照会せず、ゼロでも全リクエスト不可とは断定できません。
- 複数のプロジェクトやキーで同じ残高になる？
- キーはアカウントに属し、チームの Credits は共有です。本站プロジェクトは分類用で fal に別の財布を作りません。同じ残高を重複加算しないでください。
- 入金が見えない、429 や同期失敗の場合は？
- 支払い口座と公式反映を確認し、429 は時間を置いて再試行します。失敗時は旧スナップショットと元の成功時刻を保持し、ゼロを新規表示しません。credits 欠損や異通貨はエラーで、推測や自動換算はしません。金額・時刻・エラーコードだけを秘匿して共有してください。
fal.ai の公式資料
- 公式資料 · fal.ai/docs/platform-apis/v1/account/billing（新しいタブで開きます）
- 公式資料 · fal.ai/docs/documentation/model-apis/authentication/key-based（新しいタブで開きます）
- 公式資料 · fal.ai/docs/documentation/setting-up/authentication（新しいタブで開きます）
- 公式資料 · fal.ai/docs/platform-apis/v1/keys/create（新しいタブで開きます）
- 公式資料 · fal.ai/docs/documentation/setting-up/teams（新しいタブで開きます）
- 公式資料 · fal.ai/docs/documentation/model-apis/pricing（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。