401 またはキーが無効？

対象 workspace の有効で期限内の API v2 Key か確認します。安全なフォームで完全な値を貼り直し、Bearer や空白を除きます。サポートへキーを送らないでください。

403 または Authorization failed（10010）？

workspace を確認し、既存の所有者へ残高アクセスの確認を依頼します。ポータル権限が全 v2 API の委任対応を証明するわけではありません。権限拡大や所有者の主キーへの置換はせず、解決しなければ手動確認します。

Available credit が Balance より大きい理由は？

available_credit は credit_limit を含む場合があり、追加入金ではありません。pending も未決済の支払いである場合があります。主表示は data.balance で、独自に合算しません。

二つのプロジェクトで同額なのは？

プロジェクトは監視の整理単位であり、Telnyx 財布を作りません。同じ資金を複数キーで共有できます。BYOK プロバイダーや独立 managed account は別途確認し、この接続では集計しません。

支払いや新しい使用料が反映されない？

workspace と照会時刻を確認し、Manage billing の pending を確認します。更新しても ACH 決済や請求反映は即時になりません。監視値が変わらないだけで再入金しないでください。

404・422・429・503・null または通貨エラー？

最新の同期エラーを確認し、制限や障害時は待ってから再試行します。必要なら公式状態/サポートを確認します。欠落、不正値、USD 以外は拒否し旧成功時刻を保持します。API URL の変更、ゼロの推測、非公開 API は使いません。

Telnyx 残高確認：API Key の設定と請求照合ガイド

実アカウントでの確認待ち

ガイド更新日：2026-10-15

公式資料に基づく実装です。実アカウントのキー作成、権限、workspace、金額と手順はユーザーによる検証待ちです。自動テストは実際の請求照合を意味しません。

必要な認証情報: Telnyx API v2 Key
監視通貨: USD · 米ドル
監視の対象: アカウント残高 · USD; 固定 GET https://api.telnyx.com/v2/balance を使用します。data.balance は既に USD です。balance=300.00 は $300 であり $3 ではありません。scope=account は認証されたアカウントの Telnyx サービス全体で、音声 AI・推論・プロジェクト・キー専用の財布ではありません。

キーを預けず Telnyx を手動確認する

Mission Control に自分でログインし、上部から正しい組織/workspace を選びます。
プロフィール/設定 → Manage billing で USD Balance を確認します。Available credit、支出上限、BYOK の外部請求ではありません。
時刻と pending 状態を記録し同一アカウントの値を比較します。信用枠を足したり同じ接続を合算したりしません。

Telnyx の公式ページを開く

Telnyx を Quota Monitor に接続する

AI 利用料を支払うアカウントを選ぶ
下の Mission Control へ自分でログインします。上部の組織選択から対象 workspace を選び、現在のコンテキストを示すバナーを確認します。
プロフィール/設定から Manage billing を開き、アカウント、USD Balance、確認時刻を私的に記録します。別通貨、ゲートウェイ支出上限、外部 BYOK 請求を見ている場合は中止してください。
Telnyx の公式ページを開く（新しいタブで開きます）
既存の権限を確認する
このアカウントの API v2 Key 管理と残高読み取り権限が必要です。アカウント管理グループはありますが、キーの残高専用 scope は公開されていません。ポータルの閲覧専用ロールからキーも読み取り専用だと推測しないでください。
既に許可されたアカウントを使うか、所有者に確認を依頼します。この手順のために管理者設定や組織所属を変更したり、所有者の本番キーを共有したりしないでください。安全な委任ができなければ手動で確認します。
専用 API v2 Key を作成する
下の API Keys、またはアカウントアイコン → Account Settings → API Keys を開きます。workspace を再確認し、API V1 Tokens ではなく Create API Key を選びます。
Quota Monitor balance などの識別用ラベルを付けます。運用可能なら Expiration で Set Expiration Date を選び、作成します。本連携のために番号購入・入金・モデル実行・権限 JSON は必要ありません。
Telnyx の公式ページを開く（新しいタブで開きます）
一度だけ表示される値を保管する
作成画面を離れる前に、完全なキーをパスワードマネージャーへ保存します。引用符や Bearer を含めません。ラベル、伏せ字の末尾、API v1 Token は代用できません。
紛失したら専用キーを作り直し、不要な監視用キーだけを無効化します。他のアプリのキーを失効させないでください。チャット、画像、URL、ブラウザー開発ツールへ値を貼らないでください。
Quota Monitor のプロジェクトに追加する
対象プロジェクトで接続を追加し Telnyx を選びます。接続名を入力し、キーをマスクされた欄に貼って保存します。MCP ではキーを agent に渡さず、安全な設定リンクを使います。
Telnyx と USD が選ばれていることを確認します。上流アカウント ID、請求グループ、プロジェクト ID、キー ID、カスタム URL は不要です。同じ資金なら既存接続の再利用を検討します。
最初の残高同期を確認する
初回同期を待つか、カードの残高更新 / Sync balance を選びます。最終成功時刻が更新され USD のアカウント残高が表示されることを確認します。接続保存だけでは成功ではありません。
サーバーは Bearer 認証で GET https://api.telnyx.com/v2/balance だけを読みます。モデル実行・送金・購入は行いません。エラーを今回取得したゼロ残高として扱いません。
残高・信用枠・未決済額を別々に照合する
同じ Mission Control workspace の Manage billing に戻り、USD Balance と telnyxBalance.balance を比較します。公式例の balance=300.00、credit_limit=100.00、available_credit=400.00、pending=10.00 なら主表示は $300 です。
明細は別々に見て、$410 と合算したり使用料を再び引いたりしません。時刻と pending を確認して再照会します。不一致が続けば未検証のまま、秘密を送らず公式サポートへ相談します。
Telnyx の公式ページを開く（新しいタブで開きます）
公式ポータルを使い、安全に交換する
カードの Open provider から Mission Control へ戻り、workspace を再確認して Manage billing を開きます。支払いや設定変更は別途ご自身で判断します。自動入金は行いません。
期限前に交換用の専用キーを作り、安全なフォームで更新して読み取り成功を確認します。その後、旧監視キーだけを無効にし、他アプリへ影響がないことを確認します。
Telnyx の公式ページを開く（新しいタブで開きます）

Quota Monitor が取得する Telnyx のデータ範囲

credit_limit は信用枠、available_credit は残高と信用枠を含む値、pending は未決済額です。それぞれ別表示し、主残高へ足しません。欠落した明細は不明でありゼロではありません。
workspace ごとに組織が異なります。複数のキーや Quota Monitor プロジェクトで同じ資金を共有しても合算しません。請求グループや managed account の切り替え・集計は行いません。
BYOK の料金は外部プロバイダーが請求します。ゲートウェイの支出上限、無料 AI 枠、サービス利用資格、請求書合計は対象外です。正の残高でも利用可能とは限らず、ゼロと負の値も保持します。
支払いと請求反映には遅延があります。ACH は pending のまま残高に未反映の場合があります。更新は再照会であり決済を早めません。同じアカウント・通貨・時刻を比較してください。
REST/MCP の telnyxBalance.balance、creditLimit、availableCredit、pending は正確な小数文字列です。主残高の欠落/null、USD 以外、不正な値や照会失敗時は以前の成功結果と時刻を保持します。
ダッシュボードには、最後に成功した照会結果を表示します。手動更新で再照会できますが、プロバイダーの請求反映の遅延は解消できません。照会が失敗したあとに残る古い残高は、新しい結果ではありません。

Telnyx のよくある質問とトラブルシューティング

401 またはキーが無効？: 対象 workspace の有効で期限内の API v2 Key か確認します。安全なフォームで完全な値を貼り直し、Bearer や空白を除きます。サポートへキーを送らないでください。
403 または Authorization failed（10010）？: workspace を確認し、既存の所有者へ残高アクセスの確認を依頼します。ポータル権限が全 v2 API の委任対応を証明するわけではありません。権限拡大や所有者の主キーへの置換はせず、解決しなければ手動確認します。
Available credit が Balance より大きい理由は？: available_credit は credit_limit を含む場合があり、追加入金ではありません。pending も未決済の支払いである場合があります。主表示は data.balance で、独自に合算しません。
二つのプロジェクトで同額なのは？: プロジェクトは監視の整理単位であり、Telnyx 財布を作りません。同じ資金を複数キーで共有できます。BYOK プロバイダーや独立 managed account は別途確認し、この接続では集計しません。
支払いや新しい使用料が反映されない？: workspace と照会時刻を確認し、Manage billing の pending を確認します。更新しても ACH 決済や請求反映は即時になりません。監視値が変わらないだけで再入金しないでください。
404・422・429・503・null または通貨エラー？: 最新の同期エラーを確認し、制限や障害時は待ってから再試行します。必要なら公式状態/サポートを確認します。欠落、不正値、USD 以外は拒否し旧成功時刻を保持します。API URL の変更、ゼロの推測、非公開 API は使いません。

Telnyx の公式資料

Quota Monitor が作成したガイドで、プロバイダーの公式チュートリアルではありません。画面や権限は変更される場合があるため、公式ページも確認してください。検証済みの範囲は、ここに記載した内容に限られます。