ガイド更新日：
2026 年 10 月 1 日にユーザーから残高取得の成功報告がありました。正確な金額、サブユーザーのポリシー、用途制限付き資金の範囲、MCP 照合は独立して記録されていません。手順は公式資料に基づき、クラウドコンソールで個別に実行確認したものではありません。
- 必要な認証情報
- サブユーザーの Access Key ID + Secret Access Key
- 監視通貨
- CNY · 人民元
- 監視の対象
- クラウドアカウントの現金残高
- 公式の cashBalance を、推計や与信の加算をせず取得します。Qianfan、キー、プロジェクト単位ではなく共有クラウドアカウントの資金です。オンライン利用と個別精算で使える資金が異なる場合がありますが、API はその内訳を返しません。財務コンソールで適用範囲を確認してください。
Baidu AI Cloud / Qianfan（中国） を Quota Monitor に接続する
中国アカウントと現金残高を確認する
実際の Qianfan 支払い元の Finance → Billing Overview → Account Overview を開きます。CNY の現金と資金の用途制限を確認し、企業、委任、個別精算の場合は財務担当者に確認してください。サイトや通貨が異なる場合は中止します。
管理者がサブユーザー管理を開く
アカウントメニューから Multi-user Access Control → User Management → Sub-users → Create Sub-user を開きます。IAM は既存アカウント内の ID を管理するもので、新しい Baidu アカウントは不要です。管理者は自分のキーを提出せずにアクセスを設定します。
プログラムアクセス専用ユーザーを作成する
quota-monitor などの専用名を使用します。プログラムアクセスのみ有効にし、コンソールのパスワード、管理者テンプレート、強い権限のグループは設定しません。ほかの業務のユーザーを変更しないでください。
初回の AK/SK を保存する
作成時に対応する ID と Secret を安全にコピーまたはダウンロードします。2025 年 5 月 15 日以降、Secret の平文表示は作成時のみです。保存し忘れた場合は後述の交換用キー作成へ進みます。メインアカウントのキーはコピーしないでください。
財務読み取り専用システムポリシーを付与する
ユーザーの Permissions で財務読み取り専用の FCReadAccessPolicy を選びます。カスタム JSON、リージョン、プロジェクト ID は不要です。財務記録、インボイス、契約、注文、クーポンも参照できますが、支払いや注文取消はできません。FCFullControlPolicy、FCOrderAccessPolicy、管理者権限は選ばないでください。
ユーザーにポリシーが表示されることを確認します。残高 API の資料には詳細な権限対応がないため、初回の実照会で確認してください。失敗しても全権限キーで回避しないでください。
有効な権限をすべて確認する
直接付与されたポリシー、グループ、明示的な拒否、組織制限、アクセス元制限を確認します。預けてもよいと判断した財務参照権限だけにしてください。広い請求情報の参照を許容できない場合は接続しないでください。確認済みの残高専用アクションはありません。
必要なら交換用キーを作成する
対応する組を保存済みなら省略できます。なければ管理者がこのサブユーザーの AccessKey 管理で作成し、本人確認後に安全に保管します。IAM 管理権限を付けたり、無関係なキーを無効にしたりしないでください。長期認証情報のみ対応し、STS は非対応です。
Baidu AI Cloud に接続する
プロジェクトで Baidu AI Cloud / Qianfan の中国サイト接続を選び、マスキングされた欄に AK/SK を入力します。リージョン、エンドポイント、Qianfan プロジェクト ID、モデルキーは不要です。保存して同期を待ちます。認証情報はまとめて暗号化し、AK の末尾 4 文字のみ表示します。
公式の現金残高と比較する
更新し、財務コンソールの同一アカウント、CNY の現金項目、時刻をそろえて比較します。与信、利用可能額、リソースパック、プロジェクト予算と比較しないでください。用途制限、支払い関係、精算の遅延を確認します。更新失敗後は過去の結果が残ります。チャージは公式サイトでのみ行います。
Quota Monitor が取得する Baidu AI Cloud / Qianfan（中国） のデータ範囲
- 通貨は返りません。中国サイトの CNY アカウントのみ対応し、別サイトや他通貨の請求には使えません。
- 与信枠、クーポン、リソースパック、無料トークン、Coding Plan の枠は対象外です。出金可能額やモデル利用可否を保証する値ではありません。
- 取得結果は精算より遅れる場合があり、用途制限付き資金や企業の支払い関係にも左右されます。同じアカウント資金をプロジェクト間で重複加算しないでください。
- 公式の財務読み取り専用システムポリシーは文書化されていますが、確認済みの残高専用アクションは提供されていません。ポリシー JSON を独自に作ったり、実際のサブユーザー権限が検証済みだと説明したりしません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Baidu AI Cloud / Qianfan（中国） のよくある質問とトラブルシューティング
- Qianfan キーが使えないのはなぜですか？
- 財務 API は BCE 署名付きのクラウド AK/SK を使います。モデル Bearer キー、アプリキー、OAuth トークン、メインアカウントのキーは使用しません。
- 残高専用の JSON ポリシーがないのはなぜですか？
- FCReadAccessPolicy は文書化されていますが、利用できる単一アクションのポリシーは未確認です。この広いシステムポリシーも、実際のサブユーザーで確認する必要があります。
- FCReadAccessPolicy が見つからない、またはアクセス拒否になる場合は？
- 管理者に正しいアカウントのシステムポリシー、キー所有ユーザーへの付与、明示的な拒否、組織制限を確認してもらってください。Baidu サポートにはマスキングしたコードと時刻を伝え、SK や管理者キーは送らないでください。
- Secret Key を紛失した、または拒否される場合は？
- 管理者が専用ユーザーの新しい組を作成し、安全な方法で更新します。本番用のキーは無効にしないでください。コピー内容と有効状態を確認し、時刻エラーが続く場合はサーバー時刻を確認します。
- 現金と Qianfan の利用可能枠が異なるのはなぜですか？
- cashBalance は与信、クーポン、パック、用途制限の内訳を含みません。同じアカウント、項目、時刻で比較し、金額の加算やモデル利用可否の推定はしないでください。
Baidu AI Cloud / Qianfan（中国） の公式資料
- 公式資料 · cloud.baidu.com/doc/Finance/s/Skhtyytwu（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/Finance/s/Zlbu72qyo（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/Finance/s/6jxediakc（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/IAM/s/njwvyc2zd（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/Reference/s/9jwvz2egb（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/Finance/s/ujwvyt43q（新しいタブで開きます）
- 公式資料 · cloud.baidu.com/doc/Reference/s/njwvz1yfu（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。