Featherless AI 余额查询与 API Key 接入教程

逐步配置管理员 API Key,监控 Featherless AI 组织美元 Credits,区分可用余额与预留金额,并完成首次对账与权限排错。

待真实账号验证

教程更新

依据官方文档实现,真实账号待验收。请验证凭据创建、权限、组织范围、金额和教程步骤;自动化测试不代表真实对账通过。

所需凭据
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,如何手动查看?

  1. 自行登录 Featherless,进入账号控制台 Billing。
  2. 选择付费组织,查看 Developer 的美元 Credits,不比较固定聊天套餐或 Hugging Face 账单。
  3. 记录总额、页面可见的预留/可用值和时间,考虑结算延迟;无需将 Key 交给本站。
打开 Featherless 官方网站(在新标签页打开)

在 Quota Monitor 中接入 Featherless AI

  1. 确认组织与计费模式

    打开下方 Featherless 官网并自行登录,进入账号控制台的 Billing,确认承担 API 费用的组织使用 Developer / request pricing。

    完成后检查:记录美元 Credits 和时间。不要仅为测试监控而变更套餐、订阅或充值。

  2. 确认已有 Admin 权限

    请组织所有者确认 Key 所有者已是组织 Admin。余额接口检查 manage_billing,Editor、Developer 或 Viewer 的 Key 无法读取。

    完成后检查:组织允许托管这把高权限 Key。官方未提供余额专用策略,不编造可复制配置,也不要仅为监控提升成员权限。

  3. 创建专用 API Key

    打开下方 API Keys 页面,保持已获准的账号/组织。点击 Create New API Key,名称填 Quota Monitor,再点击 Generate。

    完成后检查:新建独立 Key,不重置生产 Key。若页面操作不同或权限不足,先由管理员核实,不猜测绕过步骤。

  4. 安全保存完整秘密值

    Key 显示后立即复制并保存到密码管理器,官方教程说明只展示一次。只复制秘密值,不附带 Bearer、Authorization:、引号或空格。

    完成后检查:不放到聊天、截图、网址或 MCP 参数。本站不需要组织 ID 或自定义 API 地址。

  5. 在项目内添加连接

    在 Quota Monitor 打开目标项目,添加供应商连接并选择 Featherless AI,填写名称,将 Key 粘贴到遮蔽输入框后保存。MCP 用户通过安全录入链接操作。

    完成后检查:币种固定 USD,不支持项目/Key 筛选。关联另一个项目不会分割上游资金。

  6. 等待首次同步成功

    等待自动同步或手动刷新一次,同时检查成功状态和更新时间;手动刷新处于冷却时按提示等待。

    完成后检查:失败保留的旧金额并非新查询结果。缺失或 null 不应显示为零。

  7. 按组织核对三种金额

    回到同一组织 Billing,在相近时间对比相同口径。官方示例总额 $42.5、预留 $0.012、可用 $42.488。

    完成后检查:featherlessBalance.balance 为可用值而非总额。考虑五分钟结算窗口及进行中的请求;不估算补差、不重复扣除预留。

  8. 管理密钥并完成验收

    余额不足时用卡片的官方平台按钮返回 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 官方资料

教程由 Quota Monitor 整理,非供应商官方教程。平台界面和权限可能变化,请以官方页面为准;实测范围以本页说明为准。

自动监控 Featherless AI

手动登录控制台查看很容易忘。Quota Monitor 会通过官方接口替你读取 Featherless AI 的数据。

  • 默认每 10 分钟刷新一次,也可以随时手动刷新。
  • 余额不足、Key 失效或同步失败会排在总览最上方。
  • 按项目查看各平台账号,也可以通过远程 MCP 在 Claude 等 AI 助手里直接询问余额。
免费开始使用