ガイド更新日：
公式資料に基づく実装です。ログイン後のキー作成、チーム Billing 権限、公式画面との残高照合は実アカウントで未検証です。自動テストは実際の接続成功を証明しません。
- 必要な認証情報
- WaveSpeedAI API Key
- 監視通貨
- USD · 米ドル
- 監視の対象
- アカウント Credits · USD
- 固定 GET https://api.wavespeed.ai/api/v3/balance の data.balance は USD です。Bearer キーが個人またはチーム組織（scope=organization）を選びます。複数キーとサービスが共有する資金で、本站プロジェクト専用の財布ではありません。
キーを共有せず WaveSpeedAI 残高を確認する
- wavespeed.ai に API の支払いに使う ID でログインし、組織を確認します。
- Dashboard の残高を読み、wavespeed.ai/top-up の Billing で同じアカウントを確認します。この接続は USD を直接扱い、モデル別 token 枠ではありません。
- 必要なら権限のある人が公式サイトで支払い、入金後に再確認します。Quota Monitor へキーや Cookie を送る必要はありません。
WaveSpeedAI を Quota Monitor に接続する
WaveSpeedAI の支払い元を確認する
下の公式 Billing ページを開きます。ログインが必要なら普段 WaveSpeedAI で使う Google または GitHub を選び、Billing に戻ります。アプリの API 利用料を支払う個人またはチーム組織を確認します。
確認点：入金先の組織と残高を識別できること。他社経由の FLUX や Runway の枠と比較しません。監視設定だけなら購入や生成は不要です。
専用キーの権限を確認する
API Keys を開きます。チームでは既存管理者に現在の役割を確認してもらい、可能なら既存の Billing メンバーが自分用の監視キーを作成します。監視担当を Owner や Admin に昇格させないでください。
個人にはチーム役割の制限がなく、Developer/Owner/Admin キーもモデルを実行できます。許容できなければ下の手動確認を利用します。Billing は他の財務情報も読めるため残高専用ではなく、貼り付けるポリシー JSON はありません。
Generate で作成し完全なキーを保存する
API Keys で Quota Monitor balance などの識別名を入力し、Generate をクリックします。本番のアプリ用キーとは分け、作成前に対象組織を再確認します。
表示を閉じる前に完全な秘密値をパスワード管理ツールに保存します。紛失したら再作成します。確認点：名前、マスク表示や Bearer ヘッダーではなく秘密値であること。チャット、画像、URL に入れないでください。
業務プロジェクトに WaveSpeedAI を追加する
Quota Monitor の対象プロジェクトでプロバイダー接続を追加し、新しい接続から WaveSpeedAI（USD）を選択します。接続名で上流の組織を識別できるようにします。
API Key のマスク入力欄に完全なキーだけを貼り付けて保存します。アカウント ID、プロジェクト ID、API URL や二つ目の認証情報は不要です。MCP でも安全な Web 設定リンクを使い、エージェントとの会話にキーを送らないでください。
初回同期の成功を確認する
最初の照会を待つか、クールダウン後に更新します。確認点：待機表示が USD 金額と新しい成功時刻に変わること。接続一覧にはキー末尾 4 文字だけが表示され、サーバーでは暗号化して保管します。
照会失敗は残高ゼロではありません。最後の成功時刻と機密情報を除いたエラーコードを確認します。一度も成功していなければ残高は不明であり、入金済みや資金切れと判断しません。
同じ組織の公式残高と照合する
同じ個人またはチーム組織の公式 Dashboard/Billing に戻り比較します。例えば data.balance=50.25 は本站でも $50.25 です。Credits からドルへの換算はしません。
他の呼び出しが資金を消費するため、なるべく近い時刻で比較します。同一組織の複数キーは共有資金で、プロジェクト別予算ではありません。アラートに依存する前に組織ごとに照合してください。
残高が少なければ公式サイトを開く
カードの Open provider で Billing を開き、ログイン中の組織を確認します。WaveSpeedAI で支払い方法と金額を選び、そこで決済を完了します。本站が支払いを代行することはありません。
公式で入金を確認してから接続を更新し、再照合します。差があればアカウントと入金状態を先に確認してください。連続更新で決済は早まりません。自動チャージ設定はプロバイダー側で管理します。
監視キーを交換または削除する
同じ組織に新しい専用キーを作り、安全な設定画面で接続を更新します。同期成功後に旧キーを削除します。漏えいが疑われる場合は WaveSpeedAI ですぐ失効させてください。
本站で接続を無効化したりプロジェクトから外したりしても上流キーは失効しません。チームキーは作成者の現在の役割を継承し、役割変更、無効化、退会で監視が止まることがあります。チーム変更後は権限を再確認します。
Quota Monitor が取得する WaveSpeedAI のデータ範囲
- 公式残高を直接使用します。50.25 は $50.25 であり、モデル Credits やセントではありません。利用量の再控除や同一組織の重複合算はしません。
- 現金・特典の内訳や個別の与信枠は返されません。それらを推測したり、基盤モデルの元プロバイダー残高を WaveSpeedAI の資金と見なしたりしません。
- ゼロと負数を含む数値を保持します。欠落、不正形式、失敗時は前回の成功値と時刻を保持し、ゼロを作りません。照会時刻は決済完了時刻ではなく、残高だけではモデル利用可否を保証できません。
- 固定の残高照会のみです。生成、支払い、チャージ、設定変更は行わず、任意エンドポイントや追加の組織・プロジェクト絞り込みは受け付けません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
WaveSpeedAI のよくある質問とトラブルシューティング
- 401 または認証情報が無効と表示される場合は？
- WaveSpeedAI を選択し、完全で有効なキーを使っているか確認します。Bearer、ヘッダー名、空白、改行を除きます。名前、ブラウザー Cookie、他社モデルのキーは使えません。安全なフォームだけで交換してください。
- 403 なら Owner や Admin キーが必要ですか？
- この残高照会のために昇格する必要はありません。現在のチーム Billing メンバーのキーを使えます。作成者が正しい組織に在籍し、有効で適切な役割か既存管理者に確認してもらいます。役割変更は既存キーにも影響します。
- キーを billing と命名すれば読み取り専用になりますか？
- なりません。権限は名前ではなく作成者の役割で決まります。Billing キーはモデルを実行できませんが他の財務情報も読めます。個人キーには同じ制限がありません。認証情報の方針を満たせなければ手動確認を使います。
- 二つのプロジェクトの残高が同じなのはなぜですか？
- キーが同一の個人またはチーム組織に属している可能性があります。本站のプロジェクトは業務の分類で、WaveSpeedAI の別財布ではありません。重複合算や利用料の再控除はしません。
- ゼロ、負の残高、月間与信枠はどう扱いますか？
- 公式の数値をゼロや負数も含めて保持します。この応答には個別の与信、現金、特典内訳がないため再計算しません。ゼロで必ず利用停止する、または正数ならモデルが必ず使えるとは判断しません。
- 429、不正応答、チャージ未反映の場合は？
- 制限後は更新のクールダウンを待ちます。正しい組織への入金を確認してから再照会してください。HTTP 200 でも業務エラーや data.balance 欠落は成功ではなく、旧値の時刻を保持します。報告は機密情報を除いたコードと時刻に限り、キーや生の応答は送らないでください。
WaveSpeedAI の公式資料
- 公式資料 · wavespeed.ai/docs/check-balance（新しいタブで開きます）
- 公式資料 · wavespeed.ai/docs/api-authentication（新しいタブで開きます）
- 公式資料 · wavespeed.ai/docs/get-started-api（新しいタブで開きます）
- 公式資料 · wavespeed.ai/docs/payment-methods（新しいタブで開きます）
- 公式資料 · wavespeed.ai/docs/how-pricing-works（新しいタブで開きます）
- 公式資料 · wavespeed.ai/docs/faq（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。