教程更新
依据官方文档实现，待真实账号验证；尚未登录走通建 Key、团队 Billing 权限及控制台余额对账。自动测试不能替代真实验收。
- 所需凭据
- WaveSpeedAI API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 账户 Credits · 美元
- 固定 GET https://api.wavespeed.ai/api/v3/balance 读取 data.balance，单位已经是 USD。Bearer Key 决定个人或团队组织（scope=organization）；该组织的多个 Key 和服务共享资金，不是本站项目独立钱包。
不提交 Key，手动查看 WaveSpeedAI 余额
- 在 wavespeed.ai 使用实际付费调用 API 的身份登录并确认组织。
- 在 Dashboard 读取余额，打开 wavespeed.ai/top-up 的 Billing 核对同一账号；本接入直接使用美元，不是单个模型 token 额度。
- 需补款时请有权限的人在官方完成，入账后再比较；无需向 Quota Monitor 提交 Key 或 Cookie。
在 Quota Monitor 中接入 WaveSpeedAI
确认实际为 WaveSpeedAI 付款的账号
打开下方官方 Billing 页面；需要登录时选择平时使用的 Google 或 GitHub 身份，再回到 Billing。核对实际支付应用调用费用的个人或团队组织。
完成检查：能辨认已入金的组织及其余额，不拿其他托管商的 FLUX、Runway 等模型额度对比。接入监控不需要先购买或发起生成。
选择合适的专用凭据
打开 API Keys。团队先请现有管理员确认当前成员角色，优先由已有 Billing 成员为自己创建监控 Key；不要为了监控把成员升为 Owner 或 Admin。
个人账号不受团队角色限制，Developer/Owner/Admin Key 可调用模型；不能接受此权限时用下方手动查询。Billing 也能读取其他财务信息，不是余额单动作权限；此角色式配置没有需要粘贴的策略 JSON。
点击 Generate 并保存完整 Key
在 API Keys 填写好识别的名称，如 Quota Monitor balance，点击 Generate。不要复用业务生产 Key，创建前再次确认仍在目标组织。
结果关闭前把完整秘密值存入密码管理器；丢失则重新生成。完成检查：保存的是秘密值而非名称、遮蔽预览或 Bearer 请求头。不要放到聊天、截图或 URL 中。
在本站业务项目内添加 WaveSpeedAI
返回 Quota Monitor，打开目标项目，添加供应商连接并选择新建连接，供应商选 WaveSpeedAI（USD）。用能辨认上游组织的名称命名。
只把完整 Key 填入遮蔽的 API Key 输入框并保存。不需要账号 ID、项目 ID、API 地址或第二项凭据；MCP 接入也只在安全 Web 录入链接填秘密值，不发给聊天 Agent。
确认首次同步成功
等待首次查询，或在刷新冷却结束后手动刷新。成功判据：等待状态变成美元金额，并有新的成功查询时间。列表只显示 Key 末四位，后端加密保管凭据。
查询失败不是没钱；看最后成功时间与脱敏错误码。若从未成功，金额仍为未知，不从这个状态推断账号已经入金或余额耗尽。
与同一组织的官方金额对账
回到同一个人或团队组织的官方 Dashboard/Billing，对比余额。例如 data.balance=50.25 在本站显示 $50.25；不进行 Credits 到美元的换算。
尽量相近时间核对，避免期间其他调用扣费造成差异。同组织多个 Key 的连接读的是同一笔钱，不是各项目独立预算；每个组织单独对账后再依赖告警。
余额低时打开官方平台补款
点击卡片 Open provider 到 Billing；付款前核对登录组织，在 WaveSpeedAI 选择支付方式与金额并完成付款。交易完全由官方处理，本站不代付。
官方确认入账后再刷新此连接并比较。金额不一致先查账号与入账状态，连续刷新不会加快结算；自动充值仍在供应商处设置。
轮换或撤销监控密钥
在同一组织创建替代专用 Key，通过安全页面更新连接，确认同步成功后再删除旧 Key。怀疑泄露时立即在 WaveSpeedAI 撤销，不等待例行轮换。
停用或解除本站项目关联不会撤销上游 Key。团队 Key 继承创建者当前角色，角色改变、成员停用或离队可能中断监控；团队调整后重新核对权限。
Quota Monitor 读取的 WaveSpeedAI 数据范围
- 直接采用官方余额：50.25 就是 $50.25，不是 50.25 个模型 Credits 或美元分。不再次扣减用量，不跨连接重复累加同一组织资金。
- 接口没有现金、赠金拆分或单列授信额度；本站不推算这些金额，也不把底层模型原厂钱包当作 WaveSpeedAI 余额。
- 保留官方数值，包括零和负数；缺字段、格式错误或失败保留上次成功值和时间，不造零。查询时间不等于结算时间，余额不能保证模型可调用。
- 仅执行固定余额读取，不发起生成、付款、充值或设置修改。不支持自定义端点或额外组织、项目过滤。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。
WaveSpeedAI 常见问题与排查
- 401 或凭据无效怎么办？
- 确认选择 WaveSpeedAI，复制的是完整有效 Key；去掉 Bearer、请求头名、空格和换行。名称、浏览器 Cookie 或其他平台模型 Key 不适用。只通过安全表单换 Key。
- 403 是不是要换 Owner 或 Admin Key？
- 余额查询不需要因此升级。当前团队 Billing 成员可以创建合适的 Key；请现有管理员核实创建者仍在正确组织、处于有效状态且拥有支持的角色，不盲目扩大权限。角色变化会影响已有 Key。
- Key 叫 billing 就只读了吗？
- 不是。团队权限取决于创建者角色而不是名称；Billing Key 不能跑模型但能读取其他财务信息，个人 Key 没有相同的团队角色限制。无法满足凭据政策时请手动查余额。
- 两个项目为什么显示一样的钱？
- 两个 Key 可能属于同一个人或团队组织。本站项目只做业务分组，不生成 WaveSpeedAI 子钱包；不要重复相加，也不再次扣减用量。
- 零、负余额或月授信怎么办？
- 直接保留官方返回数值，包括零和负数。此响应不单列授信、现金或赠金，本站不重算。零不等于已判定停服，正数也不保证模型可用。
- 429、格式错误或充值后没变怎么办？
- 限流后等待冷却；先确认充值进入正确组织，再刷新。HTTP 200 但业务码失败或缺少 data.balance 不算成功，保留旧值原时间。只提供脱敏错误码与时间，不分享 Key 或原始响应。
WaveSpeedAI 官方资料
- 官方余额接口（在新标签页打开）
- 官方认证与团队角色（在新标签页打开）
- 官方 API Key 创建步骤（在新标签页打开）
- 官方充值与账单（在新标签页打开）
- 官方计费范围（在新标签页打开）
- 官方登录与常见问题（在新标签页打开）
教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。