401 或凭据格式错误？

检查完整 key_id:key_secret 和冒号，去掉 Key/Bearer 前缀，确认没有到期、撤销、掩码或多余换行。不要提交 Cookie、登录 Bearer 令牌或只有 Key ID；完整值遗失则新建专用 Key。

模型可以调用，余额为什么 403？

普通 API 预设不代表有 billing:usage:read。由已有管理员在正确账户创建只含该权限的 Key，或检查 READONLY 是否可用；不要改为 FULL/旧 ADMIN 来绕过错误。确认权限仍失败时，向 fal 提供脱敏错误信息。

余额与月消费不一致，或者相差 100 倍？

current_balance 是 Credits 余额，不是已消费金额，USD 原值无需换算美分。核对账户与查询时间；本站不查询现金/赠金拆分，零余额也不能证明所有请求都不可用。

多个项目/Key 为什么金额相同？

Key 属于账户，团队资金由成员共享。本站项目只做业务归类，不在 fal 创建独立钱包；同一账户的相同 Credits 不得重复累加。

充值未显示、429 或同步失败怎么办？

先核对实际付款账户和官方入账，429 等待后再刷新。失败保留旧快照及原成功时间，不生成新的零余额。缺少 credits 或收到其他币种会报错，不估算或自动换汇；反馈时只提供脱敏金额、时间和错误码。

fal.ai 余额查询与只读 API Key 接入教程

待真实账号验证

教程更新2026-10-11

依据官方 Account Billing API 实现，待真实账号验证。登录后的权限选择、Key 创建和余额对账尚未实测；自动回归不等于真实验收。

所需凭据: fal API Key (key_id:key_secret)
监控币种: USD · 美元
可以看到什么: 账户 Credits 余额; 读取 GET /v1/account/billing?expand=credits 的 credits.current_balance，按官方 currency=USD 原值展示，不做美分换算或扣减消费。团队 Key 读取其所属账户的共享 Credits，不是单个模型、Key 或本站项目的钱包。

不接入监控，如何手动查询 fal.ai 余额？

登录 fal Dashboard，从左上角账户菜单选中实际付费的个人或团队账户。
打开 Billing，查看 Credits，而不是当月费用或某模型的单价。
需要补充资金时在官方页面自行购买，确认入账；多个团队/个人账户分别检查。

打开 fal Billing

在 Quota Monitor 中接入 fal.ai

1. 选择实际付费的个人或团队账户
登录 fal Dashboard，点击左上角账户名，切换到实际调用模型并付费的个人账户或团队，再打开下方 Billing 页面。不要为了监控额外创建团队。
完成后检查：账户名正确，可以看到目标账户的 Credits。团队 Key 由已有 Admin 创建；如果无权限，请让该管理员协助，不要把自己的角色直接升级。
打开 fal Billing（在新标签页打开）
2. 创建独立的监控 Key
保持在同一账户，打开 API Keys 页面，点击 Create Key，名称填写 Quota Monitor。不要复制业务正在使用的 Key，也不要调用创建 Key API 来替代下面的权限配置。
完成后检查：当前账户与第一步一致，新 Key 有独立名称。若只看到旧的 ADMIN/API scope 或无法选择权限，先询问 fal 或管理员，不交出完整管理 Key。
打开 fal API Keys（在新标签页打开）
3. 只保留账务读取权限
在创建页面选择自定义权限，清除不需要的权限，仅保留 billing:usage:read。若当前界面仅提供预设，可选 READONLY：官方余额接口接受它，但它还允许读取请求、日志等其他资源。
完成后检查：普通 API 预设不足以读取余额；不要选 FULL/旧 ADMIN。BILLING 也可用但范围更大，无需为本站开放。预设可能随官方调整，自定义单权限更适合固定最小授权。登录后的选择流程仍待实测。
官方 Key 权限说明（在新标签页打开）
4. 设置有效期并复制完整密钥
按团队策略设置到期时间并完成创建，把只显示一次的完整 key_id:key_secret 保存到密码管理器。冒号前后两部分都需要，不要只复制 Key ID 或 secret。
完成后检查：不含 Key 或 Bearer 前缀，不带引号、空格或换行。不要发到聊天、截图或教程反馈；丢失完整值需创建新的专用 Key，并提前安排到期更换。
官方密钥格式说明（在新标签页打开）
5. 在 Quota Monitor 项目内添加连接
打开目标项目 → 添加供应商连接 → 添加新连接，选择 fal.ai（美元）。填写易辨认的连接名，把完整值粘贴到 fal API Key 密码框，保存并接入项目。
完成后检查：仅填一个 Key，不需要 API 地址、团队 ID、项目 ID 或 Key ID。币种固定 USD，加密后仅显示末四位。MCP 用户使用安全录入链接，不把秘密值发给 Agent。
6. 首次同步并与 Credits 核对
等待首次同步或点击查询最新余额，确认成功查询时间更新，再打开同一 fal 账户的 Billing 对照 Credits。首次测试建议同时记录脱敏金额、账户选择和查询时间。
完成后检查：API 返回 24.5 USD 就显示 $24.5，不除以 100，也不再减月消费。账户、币种和查询时间需匹配；余额对账尚待真实验收。只读 Key 不能调用模型是正常权限边界，不要为测试监控开放推理权限。
核对 fal Credits（在新标签页打开）
7. 余额不足时前往官方补充 Credits
从卡片点击前往平台，在 Billing 再次确认账户；确需补充时，由有付款权限的人按官方当前购买 Credits 流程自行支付。监控接入不要求先付款或启用自动充值。
完成后检查：官方入账后再刷新本站；本站只请求账务 GET，不执行模型调用、购买、退款或修改支付设置。付款按钮与金额下限以登录后的页面为准，不在此编造固定菜单。
官方 Credits 计费说明（在新标签页打开）
8. 更换、停用并撤销专用 Key
创建相同最小权限的新 Key，在本站建立替代连接并验证成功，再移除旧连接的所有项目引用、删除不再使用的连接，最后在 fal API Keys 撤销旧的专用 Key。连接名额不足时先规划更换窗口。
完成后检查：其他业务 Key 未被修改或删除。从本站项目移除不等于在 fal 撤销 Key；不再监控时仍需到官方清理专用凭据。
管理 fal API Keys（在新标签页打开）

Quota Monitor 读取的 fal.ai 数据范围

仅监控该凭据可见的账户 Credits，不汇总其他个人/团队账户；组织合并结算应与同一账户账务核对，不按团队自行拆分。
接口不提供现金/赠金拆分、有效期、逐模型额度或请求可用状态；不猜测这些数据，也不将余额视为可提现现金。
显示最近成功查询的官方结果，observedAt 是查询时间，不是供应商结算时间。缺字段、错误币种或失败不会补零；不承诺零延迟。
余额大于零仍可能受到 Key 有效期、权限、模型访问或并发限制；多个连接看到同一钱包时不可累加。
看板展示最近一次成功查询的快照。手动刷新会重新请求供应商，但不保证上游账务没有入账延迟；失败时旧余额不能当成新结果。

fal.ai 常见问题与排查

401 或凭据格式错误？: 检查完整 key_id:key_secret 和冒号，去掉 Key/Bearer 前缀，确认没有到期、撤销、掩码或多余换行。不要提交 Cookie、登录 Bearer 令牌或只有 Key ID；完整值遗失则新建专用 Key。
模型可以调用，余额为什么 403？: 普通 API 预设不代表有 billing:usage:read。由已有管理员在正确账户创建只含该权限的 Key，或检查 READONLY 是否可用；不要改为 FULL/旧 ADMIN 来绕过错误。确认权限仍失败时，向 fal 提供脱敏错误信息。
余额与月消费不一致，或者相差 100 倍？: current_balance 是 Credits 余额，不是已消费金额，USD 原值无需换算美分。核对账户与查询时间；本站不查询现金/赠金拆分，零余额也不能证明所有请求都不可用。
多个项目/Key 为什么金额相同？: Key 属于账户，团队资金由成员共享。本站项目只做业务归类，不在 fal 创建独立钱包；同一账户的相同 Credits 不得重复累加。
充值未显示、429 或同步失败怎么办？: 先核对实际付款账户和官方入账，429 等待后再刷新。失败保留旧快照及原成功时间，不生成新的零余额。缺少 credits 或收到其他币种会报错，不估算或自动换汇；反馈时只提供脱敏金额、时间和错误码。

fal.ai 官方资料

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