FLUX API 余额查询：BFL Credits 与密钥接入教程

不提交 Key，如何手动查看 FLUX API Credits

1. 登录 dashboard.bfl.ai，选择实际为官方直连 FLUX API 付费的组织。
2. 进入 API → Credits 看当前金额，不用 API → Usage 消费统计代替；官方面值为 100 Credits = $1。
3. 不同组织分别核对。若 FLUX 由其他服务商收费，就看那个平台的账单；手动查看无需向任何人发送秘密。

在 Quota Monitor 中接入 Black Forest Labs / FLUX

1. 01

   1. 登录并确认要监控的组织

   打开下方 BFL Dashboard，登录实际使用官方 FLUX API 的付费账号；新账号需先确认邮箱。在侧栏组织选择器中选中目标组织，再进入 API → Credits。

   完成后检查：看得到目标组织的 Credits。先记下组织名称与金额；接入监控不要求新建组织、购买 Credits 或生成图片。

   打开 BFL 控制台（在新标签页打开）
2. 02

   2. 选择拥有密钥管理权限的项目

   在该组织下选择实际调用 API 的 BFL 项目，新账号已有默认项目。进入该项目的 API → Keys。Key 在哪个组织的项目创建，查到的就是哪个组织共享的 Credits。

   完成后检查：能够管理 Key。项目 Developer 可创建 Key；Billing Manager 是财务角色，不提供 API 访问。没有创建权限时，请现有项目管理员协助，不要为监控升级为组织管理员。

   打开 BFL 控制台（在新标签页打开）
3. 03

   3. 创建专用监控 Key 并理解权限

   在 API → Keys 点击 Add Key，名称填写 Quota Monitor，完成创建流程。请创建新 Key，不要直接复制线上业务 Key；名称写成监控用途不会限制它的权限。

   完成后检查：你接受本站加密保管仍可生成付费内容的 Key。目前没有已验证兼容的余额只读策略 JSON；若安全要求必须只读，请停在这里并使用手动查询章节的步骤。

   打开 BFL 控制台（在新标签页打开）
4. 04

   4. 关闭窗口前保存完整秘密值

   创建后立即复制完整秘密值并保存到密码管理器，BFL 只展示一次。新 Key 使用 bfl_ 前缀；迁移过的旧 Key 可能保留原格式。已经丢失完整值时，创建替代 Key。

   完成后检查：复制的不是名称、掩码或末四位。只粘贴 Key，不含 x-key:、Bearer、引号、空格或换行；不要放到聊天、截图、工单、URL 或第三方在线 API 测试器里。

   打开 BFL 控制台（在新标签页打开）
5. 05

   5. 在 Quota Monitor 项目内添加连接

   回到 Quota Monitor → 目标项目 → 添加供应商连接 → 添加新连接。选择 Black Forest Labs / FLUX（Credits · 美元面值），填写便于辨认的连接名称，将完整值粘贴到 BFL API Key 密码框并保存。

   完成后检查：只需要一个 Key，不填上游项目 ID、组织 ID、API 地址或 Key ID，币种固定 USD。通过 MCP 接入时，只在安全 Web 录入链接中填写秘密，不把 Key 发给 Agent。

6. 06

   6. 同步并对照同一组织的金额

   等待首次同步或点击查询最新余额，确认有新的成功查询时间。回到创建该 Key 的 BFL 项目所属组织，打开 API → Credits 核对，不要拿项目 Usage 消费统计比较。

   完成后检查：2450 Credits 应显示 $24.5 并附原始 2450 Credits。规则是 credits / 100；告警阈值与日消耗使用 USD，不再次减去消费。首次验收只记录脱敏金额、范围与时间。

   打开 BFL 控制台（在新标签页打开）
7. 07

   7. 需要购买 Credits 时前往 BFL

   点击卡片的前往平台，重新选择同一组织并进入 API → Credits。确需补充资金时，由有付款权限的人点击 Add Credits，选择金额、核对费用并在 BFL 的付款流程中自行完成。

   完成后检查：官方金额更新后再刷新本站。接入监控不要求购买或开启 Automatic top-up；付款方式、税费和退款由 BFL 管理，本站不会扣款或修改自动充值设置。

   打开 BFL 控制台（在新标签页打开）
8. 08

   8. 安全更换并撤销旧监控 Key

   在同一项目的 API → Keys 创建替代 Key，建立新连接并验证。移除旧连接的项目引用并删除旧连接后，再到 BFL 密钥管理中撤销旧的专用监控 Key。

   完成后检查：新连接仍对应正确组织，旧 Key 已失效。删除本站连接不等于官方撤销 Key，勿撤销业务凭据；若连接名额已满，先安排替换窗口。

   打开 BFL 控制台（在新标签页打开）

Quota Monitor 读取的 Black Forest Labs / FLUX 数据范围

• 仅查询 Black Forest Labs 官方直连 API，不包括通过 fal.ai、Replicate、Kie.ai 等平台调用 FLUX 的资金。本地 FLUX / ComfyUI 与独立计费的订阅不在范围内。
• 美元面值 = credits / 100，不是可提现现金或实际付款金额，不再次扣减消费。接口不提供现金/赠金拆分、到期或项目独享额度。同一组织的余额不能跨 Key 或项目重复相加。
• 查询时间不保证是计费结算时间；正余额也不保证模型可调用，仍受权限、限流和账号限制。字段缺失、格式错误或请求失败时保留上次成功快照及时间，不捏造零余额。
• 只使用固定全球端点 api.bfl.ai 和 x-key 认证，不接受自定义地址、组织选择或区域回退。本接入不生成内容、不付款、不充值，也不修改自动充值设置。
• 看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

Black Forest Labs / FLUX 常见问题与排查

提示 401、403 或凭据格式不正确？

回到正确 BFL 项目的 API → Keys 检查监控 Key 是否仍有效。有完整值就重新复制，丢失则创建替代；去掉请求头前缀，不要用 fal.ai / Replicate / Kie.ai 的 Key。不要以 Cookie 代替或扩大管理员权限排错。

为什么金额相差 100 倍？

credits 字段的单位是 Credits，不是美元：2450 Credits = $24.5。本站同时显示两者，阈值使用美元面值。这是固定单位换算，不是费用估算，两种单位不能相加。

多个项目金额相同，或者查到了其他组织？

BFL 的 Key 属于项目，但资金在组织层共享。检查创建 Key 的项目究竟属于哪个组织；切换浏览器当前组织不会移动 Key。请使用目标组织下的专用 Key，不重复累计同一笔资金。

其他平台的 FLUX Key、只读角色或区域端点可以用吗？

本接入仅用 BFL 官方项目 Key，固定请求 api.bfl.ai。控制台 Viewer 角色不等于已确认的余额专用 API Key 权限；Billing Manager 也不提供 API 访问。其他托管商、强制区域限制或自托管模型请通过各自支持的账务方式查看。

充值后未到账、出现 429，或无法获得余额？

先核对同一组织的官方 Credits 与付款状态，遇到限流先等待再重试。留意上次成功时间，失败不是新的零余额。反馈时只给脱敏错误码和查询时间，不要发送 Key 或原始响应。

Black Forest Labs / FLUX 官方资料

• 官方公开 OpenAPI：GET /v1/credits 与 x-key（在新标签页打开）
• 官方组织、项目与 API Key 管理（在新标签页打开）
• 官方团队角色与 API 访问权限（在新标签页打开）
• 官方组织 Credits 与付款说明（在新标签页打开）
• 官方 Credits 美元面值（在新标签页打开）
• 官方入门与一次性显示密钥（在新标签页打开）
• 官方全球和区域 API 端点（在新标签页打开）

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