ガイド更新日：
BFL の公開 OpenAPI 仕様とアカウント資料に基づく実装です。ログイン後のキー作成、権限、組織残高の照合は実アカウントで未検証です。自動テストは実機検証を意味しません。
- 必要な認証情報
- BFL API Key
- 監視通貨
- USD · Credits 額面
- 監視の対象
- API Credits · USD 額面
- GET https://api.bfl.ai/v1/credits が返す credits は、キーに紐づく組織の残高です。キーは BFL プロジェクトに属しますが資金は組織で共有します。元の Credits を保持し、100 Credits = $1 で正確に換算します。Quota Monitor のプロジェクト専用資金ではありません。
キーを共有せずに FLUX API Credits を手動確認する方法
- dashboard.bfl.ai にログインし、直営 FLUX API の費用を支払う組織を選びます。
- API → Credits で残高を読み、API → Usage の消費額とは区別します。公式の額面は 100 Credits = $1 です。
- 組織ごとに別々に確認します。他社経由の FLUX はその事業者の請求画面で確認でき、秘密を誰かに渡す必要はありません。
Black Forest Labs / FLUX を Quota Monitor に接続する
1. ログインして対象の組織を確認する
下の BFL ダッシュボードを開き、公式 FLUX API の料金を支払っているアカウントでログインします。新規登録ではメール確認を済ませます。サイドバーの組織選択から対象を選び、API → Credits を開きます。
確認：目的の組織の Credits が見えます。キーを作る前に組織名と金額を確認してください。監視を接続するだけなら、別組織の作成、購入、画像生成は不要です。
2. キーを管理できるプロジェクトを選ぶ
同じ組織内で実際に API を使う BFL プロジェクトを選び、API → Keys に進みます。新規アカウントにはデフォルトのプロジェクトがあります。このキーを作るプロジェクトの所属組織が残高の対象になります。
確認：キー管理が可能です。プロジェクトの Developer はキーを作成できますが、Billing Manager は API アクセスを持たない財務ロールです。作成できなければ既存のプロジェクト管理者に依頼し、組織管理者へ昇格して対処しないでください。
3. 専用キーを作り権限のリスクを確認する
API → Keys で Add Key を選び、名前を Quota Monitor として作成を完了します。既存の本番アプリ用キーを流用せず、新しいキーを用意します。監視用という名前だけでは権限は制限されません。
確認：有料コンテンツも生成できるキーを Quota Monitor に暗号化保存することを受け入れられるか確認します。互換性を検証済みの残高専用ポリシー JSON はありません。読み取り専用が必須なら、ここで止めて手動確認を使います。
4. 画面を閉じる前に秘密値を保存する
作成直後に完全な秘密値をコピーし、パスワードマネージャーに保存します。新規キーの全体は一度だけ表示されます。新しいキーは bfl_ 形式ですが、移行済みの旧キーは元の形式の場合があります。失った場合は代替キーを作ります。
確認：コピーしたのは名前、マスク表示、末尾4文字ではなく完全なキーです。x-key:、Bearer、引用符、空白、改行は付けません。チャット、画像、サポートへの問い合わせ、URL、オンライン API テスターには貼らないでください。
5. Quota Monitor の対象プロジェクトへ追加する
Quota Monitor で対象プロジェクト → プロバイダー接続を追加 → 新規接続へ進みます。Black Forest Labs / FLUX（Credits · USD 額面）を選び、分かりやすい接続名を付け、BFL API Key のパスワード欄に完全なキーを貼り付けて保存します。
確認：キーは1つだけです。上流のプロジェクト ID、組織 ID、API URL、Key ID は入力せず、通貨は USD です。MCP では安全な Web 入力リンクにのみ秘密を入力し、エージェントとの会話には送信しません。
6. 同期し、同じ組織の金額と照合する
初回同期を待つか最新残高を照会し、成功時刻が更新されたことを確認します。そのキーを作成した BFL プロジェクトの所属組織に戻り、API → Credits を開きます。プロジェクトの Usage 消費額ではなく組織残高と比較します。
確認：2450 Credits は $24.5 と元の 2450 Credits で表示されます。式は credits / 100 です。警告しきい値と日次消費には USD を使い、使用料を再度引きません。初回検証では秘密を除いた金額、範囲、時刻だけを記録します。
7. 必要な場合だけ BFL で Credits を購入する
カードのプロバイダーを開くボタンから同じ組織を選び、API → Credits に戻ります。資金が必要なら、決済権限のある人が Add Credits で金額を選び、請求内容を確認して BFL の決済手順を完了します。
確認：公式残高に反映してから Quota Monitor を更新します。監視のためだけに購入や Automatic top-up の有効化は必要ありません。支払方法、税、返金は BFL が管理し、当サービスはカードへの課金も自動チャージ設定の変更もしません。
8. 監視キーを安全に交換・失効させる
同じプロジェクトの API → Keys で代替キーを作り、新しい接続で同期を確認します。古い接続のプロジェクト紐付けを外して接続を削除した後、BFL のキー管理画面で古い監視専用キーを失効させます。
確認：新接続が正しい組織を参照し、旧キーが無効になっています。Quota Monitor の接続削除は BFL のキー失効ではありません。本番キーを削除せず、接続枠が満杯なら先に交換時間を計画してください。
Quota Monitor が取得する Black Forest Labs / FLUX のデータ範囲
- Black Forest Labs 直営 API のみが対象です。fal.ai、Replicate、Kie.ai などを通じた FLUX、ローカルの FLUX / ComfyUI、別課金のサブスクリプションは含みません。
- USD 額面 = credits / 100 であり、出金できる現金や実際の支払額ではありません。利用費を再控除せず、現金と特典の内訳、有効期限、プロジェクト専用枠も推測しません。同じ組織の残高をキーやプロジェクト間で重複合算しないでください。
- 取得時刻は決済・計上時刻の保証ではありません。正の残高でも権限、レート制限、アカウント制約が適用されます。不完全な値、不正な応答、取得失敗では前回の正常な残高と時刻を保持し、ゼロを捏造しません。
- 固定のグローバルエンドポイント api.bfl.ai と x-key 認証のみを使います。任意ホスト、組織指定、地域へのフォールバック、生成、決済、自動チャージ設定の変更は行いません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Black Forest Labs / FLUX のよくある質問とトラブルシューティング
- 401、403、またはキー形式のエラーが出ます
- 正しい BFL プロジェクトの API → Keys でキーが有効か確認します。完全な秘密値があればコピーし直し、紛失した場合は代替を作ります。ヘッダーの接頭辞を除き、fal.ai / Replicate / Kie.ai のキーは使わないでください。Cookie や管理者権限の拡大で回避しません。
- 金額が100倍違うのはなぜですか？
- credits の単位はドルではなく Credits です。2450 Credits = $24.5 で、両方を表示します。しきい値は USD 額面で設定します。これは固定単位の換算であり、消費額の推定ではありません。両方を足さないでください。
- 複数のプロジェクトで同額、または別組織の残高になります
- キーはプロジェクト単位ですが Credits は組織共有です。キーを作成したプロジェクトの所属組織を確認してください。ブラウザーで組織を切り替えてもキーの所属は変わりません。対象組織の専用キーを使い、同じ資金を重複合算しないでください。
- 他社の FLUX キー、読み取り専用ロール、地域専用エンドポイントは使えますか？
- この接続は BFL 直営のプロジェクトキーと api.bfl.ai のみが対象です。コンソールの Viewer は検証済みの残高専用 API キー権限ではなく、Billing Manager も API アクセスを付与しません。他社ホスト、地域限定要件、自前ホストは、それぞれ対応する請求経路で確認してください。
- 購入後に反映されない、429、または残高を取得できません
- 同じ組織の公式 Credits と支払状況を確認し、レート制限後は時間を置いて再試行します。前回の成功時刻を確認してください。取得失敗を新しいゼロ残高には変えません。報告は秘密を除いたエラーコードと時刻のみとし、キーや生の応答は送らないでください。
Black Forest Labs / FLUX の公式資料
- 公式資料 · api.bfl.ai/openapi.json（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/account_management/organizations_projects（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/account_management/team_management（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/account_management/credits_billing（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/quick_start/pricing（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/quick_start/get_started（新しいタブで開きます）
- 公式資料 · docs.bfl.ai/api_integration/integration_guidelines（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。