ガイド更新日：
2026-10-17 に公式の国際 API、アカウント通貨、CAM 文書を確認して実装しました。実アカウントの最小権限、ログイン後の操作と金額照合はユーザーテスト待ちです。中国サイトの実績は引き継ぎません。代理ログイン、有料モデル実行、権限変更は行っていません。
- 必要な認証情報
- 国際サイト専用 CAM サブユーザーの SecretId / SecretKey
- 監視通貨
- USD · 国際サイトの公式取引通貨。米セントを 100 で割るだけで為替換算なし
- 監視の対象
- 利用可能与信枠（CreditBalance）· 現金ではありません
- 固定の読み取り専用 POST https://billing.intl.tencentcloudapi.com/、DescribeAccountBalance 2018-07-09、TC3-HMAC-SHA256、TempCredit=true のみです。主値は CreditBalance / 100。認証情報の国際クラウドアカウント全体（AI 以外も含む）の枠であり、Hunyuan、プロジェクト、キーの専用ウォレットではありません。請求書、支払、権限変更、モデル実行は行いません。
キーを預けず手動で確認
- ご自身で国際サイトにログインし、財務権限のある担当者が Billing Center → Payment Management → Payment を開きます。
- アカウントと USD を確認し、利用可能与信、与信総額、凍結、未払を区別します。支払チャネルの通貨や現金は CreditBalance ではありません。
- 決済で金額が変わるため確認時刻を記録します。画面と API の項目対応が不明なら Tencent Cloud に確認し、現金を独自計算しません。
Tencent Cloud 国際サイト を Quota Monitor に接続する
国際サイトの請求アカウントを確認
ご自身で console.tencentcloud.com にログインし、Billing Center → Payment Management → Payment を開きます。実際に支払う国際アカウントで、取引通貨が USD であることを確認します。中国アカウントは別の中国サイトガイドを使ってください。
確認：既存の財務権限を持つ担当者が同一アカウントの利用可能与信枠を確認できること。監視のためにチャージ、与信申請、自動支払変更はせず、管理権限がなければ既存管理者に依頼します。
専用 CAM サブユーザーを作成
管理者が CAM → Users → User List → Create User → Custom Creation を開き、Access Resources and Receive Messages を選びます。例として quotamonitor-billing-intl という専用名を入力します。AdministratorAccess が既定の Quick Creation は避けます。
確認：API 用の Programming access のみを有効にし、コンソールのパスワードログインは不要です。通知専用ユーザーは選びません。画面の認証・作成手順を完了し、管理者や広範な財務テンプレートは付与せず、既存業務ユーザーを変更しません。
単一操作ポリシーを作成
CAM → Policies → Create Custom Policy → Create by Policy Syntax で Blank Template から開始し、Next を選びます。QuotaMonitorIntlBalanceRead などの名前を付け、本文全体を下の JSON に置き換えて Complete を選びます。
確認：version は 2.0、唯一の action は finance:DescribeAccountBalance、resource は * です。API サービスは billing でも CAM 接頭辞は finance です。この操作単位の権限は特定プロジェクトに限定できず、IP 条件も非対応です。他の公式例の管理者テンプレートを残さないでください。
Tencent Cloud 国際サイト の読み取り専用ポリシー JSON
{ "version": "2.0", "statement": [ { "effect": "allow", "action": [ "finance:DescribeAccountBalance" ], "resource": [ "*" ] } ] }キーやアカウント情報を含まない JSON 全体をコピーします。
ポリシーをユーザーへ関連付け
CAM → Users → User List に戻り、専用ユーザーの Authorization を選びます。カスタムポリシーで絞り込み、QuotaMonitorIntlBalanceRead を選んで OK を押します。ユーザー詳細の Permissions → Associate Policy からも関連付けできます。
確認：ユーザーの権限一覧に関連付け済みポリシーがあり、操作が finance:DescribeAccountBalance のみであること。作成だけでは付与されません。同名があれば内容を確認するか新しい専用名を使い、他業務のポリシーを上書きしません。
同じ組のキーを安全に保存
専用ユーザー詳細の API Keys → Create Key で SecretId と SecretKey を作成し、安全なパスワード管理ツールへ一緒に保存します。ユーザー作成時に専用キーが発行済みなら、その組を使用し追加作成は不要です。
確認：国際サイトの同一サブユーザーの有効な組であること。SecretKey は作成時のみ取得できます。紛失時は管理者の既定の安全手順で交換し、他業務のキーを削除したり権限を拡大したりしません。チャット、画像、ブラウザー URL、MCP 引数へ送らないでください。
Quota Monitor で国際サイトを選ぶ
Quota Monitor の対象ワークスペース・プロジェクトで接続を追加し、「Tencent Cloud 国際サイト · USD」を選びます。「国際クラウド請求」など識別できる接続名を入力し、中国サイトを選ばないでください。
確認：SecretId と SecretKey の 2 つのマスク欄であり、Region、Uin、エンドポイント、プロジェクト ID、モデル API Key は不要です。USD 固定で、CNY や支払カードの通貨へ変更できません。
認証情報を入力して保存
SecretId を SecretId 欄へ、SecretKey を SecretKey 欄へ貼り付けて保存します。安全な設定リンクを使う場合は、ご自身のワークスペースのものか確認してください。認証情報は暗号化して保存され、その後全体を表示しません。
確認：一覧に国際サイトの接続とキーの末尾のみが表示されます。ヘルプを開くだけでは送信されず、事業者を切り替えると未保存の入力は消去されます。クラウドのパスワードやルートキーは不要です。
更新して項目別に初回照合
初回同期を待つか最新残高の照会を選び、成功時刻が更新されたことを確認します。主値 CreditBalance は米セント / 100 です。合成例の 12345.67890123456789 米セントは USD 123.4567890123456789 になります。
確認：同一の国際請求アカウントの利用可能与信枠と照合し、現金、与信総額、月次請求とは比較しません。詳細の RealBalance と RealCreditBalance は別項目のままです。画面表現が異なる場合は API 対応を確認し、主値を再計算しません。REST/MCP の tencentGlobalBalance.availableCredit はカードと一致します。
監視と検証範囲を区別
更新失敗時はエラーコードと最後の成功時刻を確認します。保持された金額は新しい照会結果ではありません。ゼロ、負値、凍結、臨時枠の意味が不明なら Tencent Cloud に確認し、停止やリセット日を推定しません。
確認：ご自身の最小権限と初回金額照合を記録してから実アカウントの検証完了としてください。本文は公開文書による手順で、ご自身の管理画面へログインして確認したものではありません。チャージ、自動支払や与信の変更は行いません。
Quota Monitor が取得する Tencent Cloud 国際サイト のデータ範囲
- 国際 USD と中国 CNY は別アカウントです。認証情報や検証実績は共有せず、中国エンドポイントへフォールバックしません。API に通貨欄はなく、USD は公式の国際アカウント定義に基づき、言語や所在地から推測しません。
- CreditBalance は利用可能与信枠です。RealBalance、RealCreditBalance、CreditAmount、FreezeAmount、OweAmount、TempCredit は個別表示し、代用・加算や総与信額からの費用推定は行いません。
- 公式例は RealBalance=0、CreditBalance と RealCreditBalance=10000000000 米セントです。似た説明でも同額とは限りません。CashAccountBalance、IncomeIntoAccountBalance、PresentAccountBalance は国際サイトで未適用のため省略し、現金ゼロとは表示しません。
- ゼロ、負値、小数米セントを保持します。主値欠落や権限拒否は失敗として以前の値・時刻を保持します。臨時与信明細の日付からも、リセット、有効期限、モデルの利用可否を推定しません。
- 同じクラウドアカウントの複数接続は同じ枠であり合算しません。Quota Monitor のしきい値や日次消費予測は独自設定で、事業者の与信、請求周期、支払を変更しません。実際の日次消費はこの API で取得しません。
- ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。
Tencent Cloud 国際サイト のよくある質問とトラブルシューティング
- UnauthorizedOperation.CamNoAuth や権限拒否？
- 専用ユーザーに version 2.0 の finance:DescribeAccountBalance、resource * のポリシーが実際に関連付けられているか、既存の権限境界や明示的拒否を確認します。billing: 接頭辞や管理者権限の追加で回避しません。
- AuthFailure、署名、時刻のエラー？
- 有効で欠落のない SecretId/SecretKey が同一国際アカウントの組か確認します。モデルキー、中国サイト認証情報、STS は非対応です。SignatureExpire はサーバー時刻を確認し、署名ヘッダーやキーはチャットへ送らないでください。
- 現金や RealBalance と一致しない理由は？
- 別の項目で、公式国際例も一致していません。主値は CreditBalance のみです。CashAccountBalance などは国際サイトでは未適用のため、現金残高を示す根拠にはできません。
- カードは KRW 決済なのに USD 表示？
- 公式の国際取引・請求通貨は USD ですが、韓国の支払チャネルは KRW で引き落とす場合があります。ここでは米セントを 100 で割るのみで、為替換算やカード通貨への追従はしません。
- 値の欠落、負値、同期失敗、429？
- CreditBalance 欠落はゼロではありません。不正形式や拒否時は前回値を保持します。負値は負値のまま表示し、429 は次回同期を待ちます。継続失敗は機密情報を除くエラーコードと時刻で調査し、上流応答全体を送らないでください。
- リセット日は？ Hunyuan プロジェクトの財布？
- クラウドアカウント共有与信であり、プロジェクトの財布やキー上限ではありません。リセット日は保証せず、臨時枠明細の日付をリセットと解釈しません。重複接続を合算せず、モデル利用可能性も保証しません。
Tencent Cloud 国際サイト の公式資料
- 公式資料 · www.tencentcloud.com/document/product/555/50284（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/378/80429（新しいタブで開きます）
- 公式資料 · www-sg.tencentcloud.com/pt/document/product/598/77527（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/555/43522（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/598/13674（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/598/58328（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/598/10602（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/598/32675（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/555/31994（新しいタブで開きます）
- 公式資料 · www.tencentcloud.com/document/product/555/9942（新しいタブで開きます）
Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。