教程更新
依据官方文档实现,真实账号待验收。请验证凭据创建、权限、组织范围、金额和教程步骤;自动化测试不代表真实对账通过。
- 所需凭据
- Featherless 组织 Admin API Key
- 监控币种
- USD · 美元
- 可以看到什么
- 组织可用 Credits · USD
- 固定 GET https://api.featherless.ai/credits/balance,读取 available_nano_usd / 1000000000 作为美元可用值,总额和预留额分别展示(scope=organization)。官方示例 available_nano_usd=42488000000 即 $42.488。
不提供 Key,如何手动查看?
- 自行登录 Featherless,进入账号控制台 Billing。
- 选择付费组织,查看 Developer 的美元 Credits,不比较固定聊天套餐或 Hugging Face 账单。
- 记录总额、页面可见的预留/可用值和时间,考虑结算延迟;无需将 Key 交给本站。
在 Quota Monitor 中接入 Featherless AI
确认组织与计费模式
打开下方 Featherless 官网并自行登录,进入账号控制台的 Billing,确认承担 API 费用的组织使用 Developer / request pricing。
完成后检查:记录美元 Credits 和时间。不要仅为测试监控而变更套餐、订阅或充值。
确认已有 Admin 权限
请组织所有者确认 Key 所有者已是组织 Admin。余额接口检查 manage_billing,Editor、Developer 或 Viewer 的 Key 无法读取。
完成后检查:组织允许托管这把高权限 Key。官方未提供余额专用策略,不编造可复制配置,也不要仅为监控提升成员权限。
创建专用 API Key
打开下方 API Keys 页面,保持已获准的账号/组织。点击 Create New API Key,名称填 Quota Monitor,再点击 Generate。
完成后检查:新建独立 Key,不重置生产 Key。若页面操作不同或权限不足,先由管理员核实,不猜测绕过步骤。
安全保存完整秘密值
Key 显示后立即复制并保存到密码管理器,官方教程说明只展示一次。只复制秘密值,不附带 Bearer、Authorization:、引号或空格。
完成后检查:不放到聊天、截图、网址或 MCP 参数。本站不需要组织 ID 或自定义 API 地址。
在项目内添加连接
在 Quota Monitor 打开目标项目,添加供应商连接并选择 Featherless AI,填写名称,将 Key 粘贴到遮蔽输入框后保存。MCP 用户通过安全录入链接操作。
完成后检查:币种固定 USD,不支持项目/Key 筛选。关联另一个项目不会分割上游资金。
等待首次同步成功
等待自动同步或手动刷新一次,同时检查成功状态和更新时间;手动刷新处于冷却时按提示等待。
完成后检查:失败保留的旧金额并非新查询结果。缺失或 null 不应显示为零。
按组织核对三种金额
回到同一组织 Billing,在相近时间对比相同口径。官方示例总额 $42.5、预留 $0.012、可用 $42.488。
完成后检查:featherlessBalance.balance 为可用值而非总额。考虑五分钟结算窗口及进行中的请求;不估算补差、不重复扣除预留。
管理密钥并完成验收
余额不足时用卡片的官方平台按钮返回 Featherless,再进入账号 Billing;是否付款由账户授权人决定。
完成后检查:用获准的新 Key 轮换并验证同步后再撤销旧 Key。移除项目关联或删除本站连接不撤销厂商 Key;仅反馈脱敏错误和时间。
Quota Monitor 读取的 Featherless AI 数据范围
- 仅适用于 Developer / request-pricing 的组织共享 Credits,不是可提现现金、本站项目钱包或单 Key 限额。多个连接可能共用资金,不能重复汇总。
- 可用值已经扣除预留,不再扣 reserved_nano_usd 或消费。整数 nano-USD 字段精确换算,不采用 _usd 展示字段替换。
- 官方按五分钟窗口结算,可能落后于实际请求。查询成功不保证费用结清或模型可用;固定聊天套餐和独享 GPU 合同不等于 API 预付余额。
- Hugging Face 路由并向 Hugging Face 付费的请求不在此范围;不要填写 hf_ token。聊天套餐中保存的 Credits 不表示套餐剩余额度。
- REST/MCP 的 featherlessBalance.balance、totalBalance、reservedBalance 保留精确美元字符串,settlementBasis=five_minute_windows。缺失、null 或不一致金额会失败并保留旧快照;零和负可用值不截断。
- 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商,但不保证上游账务没有入账延迟;失败时旧余额不能当成新结果。
Featherless AI 常见问题与排查
- 401:Key 被拒绝?
- 核对 API Keys 的完整秘密值及撤销状态,移除请求头前缀和空格。不能用 Cookie 或 hf_ token 替代。
- 403 / organization_permission_denied?
- 需要组织 Admin 的 Key 及 manage_billing。能调用模型不代表能查余额;请所有者核对所属组织和现有角色,不扩大权限或使用 Cookie 绕过。
- 可用值与页面大字金额不同?
- 页面可能显示总 Credits,而可用值已扣除处理中请求的预留额。对比相同组织和时间,不再扣一次预留。
- 缺失、null 或 invalid_response?
- 需要三个整数 nano-USD 字段及 currency=usd。格式错误或数值不一致会保留上次成功金额与时间,只反馈脱敏错误。
- 404、429 或超时?
- 等待后再试,并核对显示的时间。支持路径是 /credits/balance,不是 /v1/credits/balance;不尝试镜像网址,不把 Key 放入 URL。
- 固定套餐或 Hugging Face 费用能查吗?
- 不能。聊天套餐、独享资源及 Hugging Face 代扣范围不同。切换套餐后 Credits 可能仍保留,但只在按请求计费时使用,不代表套餐剩余额度。
Featherless AI 官方资料
- 官方资料 · api-reference-credits(在新标签页打开)
- 官方资料 · request-pricing-and-credits(在新标签页打开)
- 官方资料 · guides-roo-code(在新标签页打开)
- 官方资料 · api-overview-and-common-options(在新标签页打开)
- 官方资料 · hugging-face(在新标签页打开)
- 官方资料 · billing(在新标签页打开)
教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。