ガイド更新日:
公式 Billing API に基づく実装です。実アカウントでの検証は未完了です。キー作成、現在のチーム、金額、手順を実際に確認してください。自動テストは実残高の照合ではありません。
- 必要な認証情報
- Resemble チーム管理者 API キー
- 監視通貨
- USD · 米ドル
- 監視の対象
- チームウォレット残高 · USD
- 固定 GET https://app.resemble.ai/billing/api/v1/wallet を使用します。公式 wallet.balance_cents / 100 が現在のチームの USD 残高(scope=current_team)です。balance_cents=4250 は $42.5。現金とプロモーションの内訳は再加算しません。
API キーを共有せず手動で確認する
- Resemble 公式アプリにログインし、API の料金を負担するチームを選択します。
- 請求・ウォレット領域で USD 合計と現金・プロモーション内訳を確認します。製品枠やオートリロード設定とは比較しません。
- チームと時刻を記録します。キーを外部へ渡す必要はありません。カスタム請求契約でウォレット表示がない場合は公式サポートへ確認してください。
Resemble AI を Quota Monitor に接続する
支払うチームを確認する
下記の Resemble 公式アプリに自分でログインし、API の費用を負担するチームを選択します。請求・ウォレット領域を開き、チーム、USD 金額、時刻を記録します。
確認:対象はウォレットであり、サブスクリプション枠、製品数量、音声プロジェクトの使用量ではありません。監視テストのためにプランを変更したり入金したりしないでください。
管理者権限とキーのリスクを確認する
キー所有者が現在のチームの管理者であることを確認します。公式 Billing API にはこの役割が必要で、モデル呼び出しが成功しても請求へのアクセスは保証されません。
確認:組織がこの高権限キーの保管を許可していること。ウォレット専用 scope やコピー可能な読み取り専用 IAM ポリシーは公開されていません。監視だけのために権限を昇格せず、許容できなければ手動確認してください。
Account → API を開く
下記の公式 Account → API を開き、同じアカウントとチームを維持します。独立したキーを作れる場合は監視専用キーを作成し、命名できる場合は Quota Monitor とします。
確認:本番キーをリセットしないでください。既存キーや再生成ボタンしかない場合は、所有者と安全なローテーションを調整し、保管の承認を得るまでは手動確認を使います。
秘密値のみを安全にコピーする
完全なキーをパスワード管理ツールに保管し、秘密値だけをコピーします。Bearer、Authorization:、引用符、空白は含めません。通常の API キーはアプリと請求サーバーで使用されます。
確認:キーをチャット、スクリーンショット、問い合わせ、URL、MCP 引数に載せないこと。請求のパスは /billing/api/v1 で、/api/v2 ではありません。Quota Monitor に URL を入力する必要はありません。
プロジェクト内で接続を追加する
Quota Monitor の対象プロジェクトで接続を追加し、Resemble AI(USD チームウォレット)を選びます。識別しやすい名前を付け、マスクされた欄にキーを入力して保存します。MCP では安全な入力リンクを使い、agent にキーを渡しません。
確認:通貨は USD です。チーム、プロジェクト、キー ID の上書き指定はできません。他のプロジェクトに接続を関連付けても、上流に別ウォレットは作成されません。
最初の同期成功を待つ
初回の自動同期を待つか、最新残高を一度取得します。成功状態と更新された取得時刻を確認し、手動更新の待機時間がある場合は待ちます。
確認:失敗後も古い金額が残ることがあるため、状態と時刻を合わせて確認します。合計の欠落や null はゼロではなく、現金やプロモーション内訳の未報告もゼロとみなしません。
同じチームと単位で照合する
同じチームの請求・ウォレット画面に戻り、近い時刻の USD 合計を比較します。balance_cents=4250 なら $42.5。現金とプロモーションの内訳を合計へ再び加算しません。
確認:REST/MCP の resembleBalance.balance はカードと一致し、scope=current_team です。lifetime_consumed_cents を再度差し引いたり auto_reload 閾値と比較したりせず、差異があればチームと時刻を確認します。
アクセスを維持し実アカウント検証を行う
残高が少ない場合はカードの公式サイトボタンから Resemble を開き、権限を持つ所有者が支払いを判断します。更新キーの利用承認を得て接続を安全に更新し、同期成功を確認してから古い監視キーを失効させます。
確認:Quota Monitor のプロジェクト関連付け解除や接続削除では Resemble のキーは失効しません。報告には秘匿化したエラーコード、時刻、差額だけを含め、キーや完全なレスポンスは送らないでください。
Quota Monitor が取得する Resemble AI のデータ範囲
- キー所有者の現在のチームのウォレットです。音声プロジェクト、キー上限、Quota Monitor プロジェクト専用資金ではありません。同じウォレットを重複集計せず、所属や現在のチーム変更後は範囲を再確認してください。
- 合計は wallet.balance_cents のみから取得します。cash_balance_cents と promotional_balance_cents は内訳です。_dollars 表示値や lifetime_loaded_cents/lifetime_consumed_cents で合計を置き換えたり調整したりしません。プロモーション残高は出金可能な現金ではありません。
- サーバーは Bearer 認証でキャッシュなしの GET を一度だけ送信し、本文やリダイレクトは使用しません。モデル実行、取引一覧取得、サブスクリプション変更、auto_reload 設定、支払いは行いません。ただしキー自体は読み取り専用ではありません。
- REST/MCP の resembleBalance.balance、cashBalance、promotionalBalance は正確な USD 文字列です。内訳の欠落や null は不明のまま、合計の欠落・null や取得失敗では前回成功時の金額と時刻を保持し、ゼロにはしません。
- カスタム請求契約では API を利用できない場合があります。正の残高でも全製品の利用は保証されません。取得時刻は決済確定時刻ではなく、ゼロや負数もそのまま保持します。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Resemble AI のよくある質問とトラブルシューティング
- 401:キーが拒否される場合
- Account → API の完全なキー、有効性、所属アカウントを確認します。Bearer/Authorization プレフィックスや空白を除き、Cookie やブラウザーセッションで代用しません。
- 403 または billing_api_not_available
- キー所有者は現在のチームの管理者である必要があります。カスタム請求では管理者も利用できない場合があります。公式に適用条件を確認し、権限拡大、プラン変更、Cookie による回避は行わないでください。
- 402 や支払い認証が要求される場合
- アカウント所有者が公式アプリの請求通知を確認します。Quota Monitor は支払い認証、カード請求、プラン変更を行いません。読み取りの調査だけのために支払う必要はありません。
- 合計が欠落、null、invalid_response の場合
- 公式の数値 balance_cents が必要です。null は不明でありゼロではなく、前回成功の情報を保持します。有効な内訳の欠落は不明表示です。秘匿化したエラーと時刻のみ報告してください。
- 404、429、タイムアウトの場合
- アカウントとチームへのアクセスを確認し、制限解除を待って再試行します。上流の変更にはアダプター修正が必要な場合があります。ミラーや任意 URL は使わず、表示時刻が古いままか確認してください。
- 重複残高や Credits・使用量との差がある場合
- 現在のチームが共有するウォレットで、Quota Monitor のプロジェクトでは資金を分割しません。使用量、プラン数量、音声プロジェクト枠ではなく USD 合計を比較します。チーム変更後は範囲を再確認してください。
Resemble AI の公式資料
- 公式資料 · docs.resemble.ai/api-reference/billing-wallet/get-billing-wallet(新しいタブで開きます)
- 公式資料 · docs.resemble.ai/platform-management/billing(新しいタブで開きます)
- 公式資料 · docs.resemble.ai/platform-management/billing/wallet(新しいタブで開きます)
- 公式資料 · docs.resemble.ai/getting-started/authentication(新しいタブで開きます)
- 公式資料 · docs.resemble.ai/platform-management/account/teams(新しいタブで開きます)
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。