教程更新
依据官方文档实现。真实账号的凭据创建、权限、工作空间、金额与教程步骤仍待用户验证；自动化检查不代表真实账务验收通过。
- 所需凭据
- Telnyx API v2 Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户余额 · USD
- 固定 GET https://api.telnyx.com/v2/balance。data.balance 已是美元：balance=300.00 即 $300，不是 $3。scope=account 涵盖该凭据账户承担费用的 Telnyx 服务，不是语音 AI、推理、本站项目或 Key 的独立钱包。
无需托管 Key 的手动查询
- 自行登录 Mission Control，用顶部选择器确认组织/workspace。
- 进入个人资料/设置 → Manage billing，读取 USD Balance，不读 Available credit、消费上限或 BYOK 外部账单。
- 记录时间和 pending 支付状态，与本站同账户金额比较，不加信用额度、不累计重复连接。
在 Quota Monitor 中接入 Telnyx
选中实际承担 AI 费用的账户
打开下方 Mission Control 并自行登录，用顶部组织选择器切换到要监控的 workspace，核对当前工作空间提示。
从个人资料/设置进入 Manage billing，私下记录账户范围、USD Balance 和时间。如果看到其他币种、网关消费上限或外部供应商的 BYOK 账单，请停止：这些不是本接入的金额。
确认现有权限，不额外提权
需要能够管理该账户的 API v2 Key 并读取余额。Telnyx 有账户管理权限组，但未给此类 API Key 提供公开的余额单动作 scope；门户只读角色不等于 Key 只读。
请使用已获授权的账户，或让现有所有者审查权限。不要为本教程开启管理员模板、共享所有者生产主 Key 或改变组织成员。无法安全授权时使用下方手动查询。
创建单独的 API v2 Key
打开下方 API Keys，或点击账户头像 → Account Settings → API Keys。再次确认 workspace，选择 Create API Key，不是 API V1 Tokens。
填写可识别名称，例如 Quota Monitor balance。Expiration 中可选 Set Expiration Date，并安排轮换，然后创建。本接入不需要购买号码、充值、调用模型或粘贴权限 JSON。
保存仅显示一次的完整值
离开创建窗口前把完整 Key 保存到密码管理器。不要带引号或 Bearer 前缀；名称、遮蔽后缀和 API v1 Token 都不是凭据。
若遗失，重新创建专用 Key，仅停用不再使用的监控 Key，不撤销其他应用的密钥。不得放入聊天、截图、URL 或浏览器开发者工具。
在 Quota Monitor 项目内添加连接
打开目标项目，添加供应商连接并选 Telnyx，填写连接名称，将 Key 粘贴到遮蔽凭据框后保存。MCP 用户通过安全录入链接提交，不把 Key 发给 agent。
检查服务商为 Telnyx、币种为 USD；无需上游账户 ID、账单组、项目 ID、Key ID 或自定义地址。同一份资金优先复用已有连接。
运行第一次余额同步
等待首次同步，或点击卡片的查询最新余额 / Sync balance。检查最近成功时间更新，显示美元账户余额；仅保存连接不等于查询成功。
服务端只以 Bearer 认证读取 GET https://api.telnyx.com/v2/balance，不调用模型、不转账或购买。错误必须保留为错误，不能冒充本次查得零余额。
分别核对余额、信用与待入账
回到同一 Mission Control workspace 的 Manage billing，将 USD Balance 与 telnyxBalance.balance 对比，不与 Available credit 混淆。官方示例 balance=300.00、credit_limit=100.00、available_credit=400.00、pending=10.00 的主金额仍是 $300。
三项明细分别查看，不能显示 $410，也不能再减消费。先核对时间和待入账状态，再重试；仍不一致时保持未验收，并向官方咨询，不发送秘密。
使用官方入口并安全轮换
余额不足时用卡片的平台跳转返回 Mission Control，确认 workspace 后打开 Manage billing。是否付款或改账户是独立决定，本站不自动充值。
到期前新建替代专用 Key，在安全表单更新并验证读取成功，再仅停用旧监控 Key。完成后检查其他应用不受影响。
Quota Monitor 读取的 Telnyx 数据范围
- credit_limit 是信用额度，available_credit 包含余额与该额度，pending 是未结算金额。三者单独展示，不额外加到主余额。分项缺失表示未知，不补零。
- 不同 workspace 对应不同组织。多个 Key 和本站项目可能共享资金，不能重复相加；不执行账单组或 managed account 切换与合并。
- BYOK 费用仍由外部供应商结算。本接入不查询网关消费上限、免费 AI 套餐、服务可用资格或发票总额。正余额不保证可调用，零与负值保留。
- 支付和账务可能延迟，ACH 入账前可先显示为 pending。刷新只重新查询，不加快结算；必须比较同一账户、币种和时间。
- REST/MCP 的 telnyxBalance.balance、creditLimit、availableCredit、pending 保留精确小数字符串。主余额缺失/null、非 USD、畸形值或查询失败时保留原成功快照与时间。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
Telnyx 常见问题与排查
- 401 或凭据无效？
- 确认是目标 workspace 内启用、未到期的 API v2 Key。通过安全表单重新粘贴完整原值，去掉 Bearer 和空白，不把 Key 发给客服。
- 403 或 Authorization failed（10010）？
- 核对 workspace，让现有所有者审查余额读取权限。门户权限组不证明所有 v2 API 都支持委派。不要自行提升角色或改用所有者主 Key；无法读取时手动查账。
- 为什么 Available credit 比 Balance 大？
- available_credit 可以包含 credit_limit，它们不是额外充值。pending 也可能是未结算支付。本卡片只取 data.balance，不自行合计。
- 为什么两个项目金额相同？
- 本站项目只用于监控分组，不创建 Telnyx 钱包。多个 Key 可共享同一账户；BYOK 供应商与独立 managed account 应分别核对，本接入不聚合。
- 付款或新增消费尚未体现？
- 先核对 workspace 与查询时间，再查看 Manage billing 的 pending。刷新不能让 ACH 或账务立即结算，不要仅因监控未变化就重复付款。
- 404、422、429、503、null 或币种不支持？
- 查看同步错误；限流或服务异常先等待再重试，必要时查询官方状态/支持。缺失、畸形和非 USD 余额会失败并保留旧时间；不要修改 API 地址、猜零或使用私有接口。
Telnyx 官方资料
- 官方余额字段（在新标签页打开）
- API v2 Key 创建、到期与轮换（在新标签页打开）
- Bearer 认证与固定余额 GET（在新标签页打开）
- 工作空间与账户范围（在新标签页打开）
- 组织权限限制（在新标签页打开）
- ACH 待入账与门户余额（在新标签页打开）
- AI Gateway 与外部 BYOK 账单（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。