GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
全部教程与指南

· reAPI Team

fal User is locked 错误排查:账户、密钥与余额

排查 fal User is locked 错误:检查响应、账户、余额和密钥权限。重试或继续付款前,先准备好提交给支持团队的证据。

fal User is locked 错误排查:账户、密钥与余额

充值后,User is locked 仍可能反复出现。在 fal 的公开 issue 922 中,用户描述了这种不一致:控制面板显示有余额,但请求仍收到锁定响应。该讨论串记录了不同用户报告的修复方法和失败经历;维护者最终建议受影响的用户联系账户专属支持。[1]

这段经历并不能确定你的错误原因。但它说明,“再充点钱”或“再创建一把密钥”并不是完整的答案。请先查看 API 返回的完整原因、运行中应用背后的账户,以及错误发生时间。在这些事实尚未查明前,暂停应用的自动提交。

保留“Reason”后面的文字

余额耗尽消息和管理锁定消息不应合并为同一条日志。保留完整响应正文,以及 HTTP 状态码、端点、方法和时间戳。只保留 403 的日志已经丢弃了你下一步决策所需的信息。

然后确认失败的是哪项操作。应用是在提交新的生成任务、检查已被接受的请求,还是尝试获取其结果?工作流末尾显示的 SDK 异常可能来自其中任何一步。补救办法取决于实际收到拒绝的步骤。

考虑一个假设情形:提交返回请求 ID,工作进程保存了它,而之后的一次轮询收到锁定错误。这一过程不能证明较早的生成失败或已取消。请保留该 ID 以及两项操作的响应。重放整个工作流会创建新的提交,却无法查明现有请求的结果。

相反,如果初始提交遭到拒绝且没有返回请求 ID,就记录这一具体结果。不要编造任务标识符,也不要根据授权消息指定最终生成状态。你现在调查的是这项操作是否获准,而不是评估生成媒体的质量。

fal 已完成状态指南介绍了另一种情况:已知请求达到终止状态,但媒体缺失。将这些情况区分开来,可以避免账户问题引发不必要的重新生成。

解读余额前先核对账户

fal 的 FAQ 称,账户余额低于账户锁定阈值时会被锁定。对于这种情况,它建议充值;企业发票账单则另行处理。[2] 这条规则并不意味着任何显示的正数余额都能保证每个账户均可访问。

首先,将应用密钥所属账户与控制面板中选定的账户对应起来。必要时也要核对团队上下文。浏览器中可能显示已充值的团队,但工作进程使用的是个人密钥;这是需要排查的可能性,并非我们已确定的请求原因。

使用你常规的密钥管理工具检查运行中进程的配置。密钥名称或安全标识符有助于确认来源,无须打印密钥本身。如果有人最近更换了凭证,请确认部署实际加载了预期配置。更新本地环境文件,不能证明独立工作进程使用了什么配置。

对照已知时间点的余额记录和错误。例如,在充值前截取的屏幕截图,无法显示后来请求失败时余额是否已经变化。请一并记录收据时间、控制面板截图时间和操作失败时间。这样支持团队就能查看事件顺序,而不是面对两张没有日期的截图。

如果受影响账户的余额和返回原因符合文档所述的充值阈值,请遵循相应账单指南。如果已完成的购买没有到账,请调查购买与额度记录。如果正确账户显示有余额,但锁定原因仍不清楚,再次充值并不能证明问题会因此解决。

登录控制面板与 API 访问也是不同操作。如果你无法通过 GitHub 登录,因为始终收不到一次性验证码,fal 的 FAQ 建议检查 GitHub 账户的主邮箱。[2] 这或许能帮助你进入账户页面,但不能解释已配置好的应用为何收到账户锁定响应。

账户有余额,密钥策略仍可能不匹配

fal 文档介绍了权限预设、自定义权限列表、允许使用的模型限制以及密钥到期时间。其 API 预设用于调用托管模型。[3] 这些控制项决定凭证可以执行什么操作;余额反映现有资金。修正其中一项并不能证明另一项也正确。

将准确的失败操作与密钥策略进行对照。如果密钥仅限于某些模型,请检查目标端点是否受到该限制。如果密钥已过期,应更正凭证,而不是充值。如果客户端发送的密钥与预期不同,应先修正配置,再更改账户权限。

一个容易忽略的细节是策略的创建方式。fal 表示,预设密钥遵循当前预设定义,而自定义策略会保留创建时的权限列表。添加模型限制会将密钥保存为自定义策略。[3] 因此,为同一应用创建的两把密钥都值得分别检查,不应假定它们的权限始终相同。

不要为了观察错误是否变化,就给每把密钥授予完全访问权限。只授予应用所需的操作,并在调查记录中保留原有策略。若同时进行多项更改后请求成功,你就无法确定究竟是哪项更改起了作用,而且可能留下超出应用需求的权限。

同样,更换密钥并不是有文档依据的通用账户解锁操作。在 issue 922 中,有些用户报告更换新密钥或更新 SDK 后成功,另一些用户则称这些步骤无效。[1] 这些只是个人观察,不能据此断定 SDK 版本、密钥迁移或延迟解锁是所有类似消息的原因。

比较两个客户端时,先确保目标账户、模型和操作一致。笔记本电脑上对某个模型的成功请求,不能证明定时工作进程可以访问另一个模型。选择修正方法前,先记录剩余差异。否则,模型或账户的变化可能被误认为是客户端库问题已修复。

如果证据指向客户端,请检查已安装的客户端版本和请求构造方式。更改软件包前,先保存完整的服务响应。这样才能区分客户端配置修正与需要服务提供方处理的账户限制。

托管模型与 Serverless 部署需要不同的检查

如果你只调用 fal 的托管 Model API,安装指南称你需要 API 密钥和客户端 SDK,而不需要 Serverless CLI。部署自己的 Serverless 应用需要账户批准;调用托管 Model API 则不需要该批准。[4]

当搜索结果引导你安装 CLI 或切换团队时,这一点很重要。请确认这些步骤适用于收到错误的产品和进程。CLI 配置文件能够正常工作,本身并不能证明独立部署的 Web 服务使用了哪项凭证。

对于浏览器应用,fal 建议将密钥保存在服务器端代理之后。[2] 把密钥放进浏览器代码并不能修复账户锁定。请检查代理实际使用的凭证和返回的错误,并让身份验证留在服务器端。

给支持团队提供一个账户和一段事件经过

对于原因不明的锁定,维护者的指引是使用受影响账户的同一邮箱联系 fal 支持团队。锁定个案会逐一处理;在公开 issue 中发表评论无法解锁账户。[1]

简洁的私人报告可以采用以下格式:

账户:[受影响的账户]。在 [UTC 时间],[操作和端点] 返回了[经过脱敏的完整错误]。应用使用属于[账户或团队]的[安全凭证标识符]。在[截图时间],该账户显示[余额]。如相关,购买[参考编号]记录于[时间]。如有请求 [ID],它在后续错误之前已被接受。请检查此处所示的账户限制和操作。

补充客户端名称和版本,并说明已完成哪些检查。删除授权标头、API 密钥和不必要的付款详情。清楚描述观察结果:使用的密钥、收到的响应以及显示的余额。避免将记录无法证明的问题归咎于数据库故障或账单动机。

若你参考某个 issue,请查看维护者的最新回复。另一份报告 issue 1163 在维护者表示支持团队此前已解决该账户问题后关闭。[5] 这不能证明所有账户都已修复,正如最初的报告也不能证明当前仍在发生故障。不能从任一讨论串推断出通用等待时间或退款承诺。

如果支持团队表示账户已解锁,请回到失败的操作。对于前述“任务已接受、之后轮询被拒绝”的假设情形,先检查现有请求。访问恢复后或许可以获取其状态,但不能保证生成本身成功。将新的响应与先前的锁定消息一并保存。如果同一操作仍然失败,请在现有支持对话中发送更新后的时间戳和响应,以便团队根据当前账户状态进行审核。

访问恢复后,先检查暂停的工作再继续。区分遭到拒绝的提交与已取得 ID 的任务,并在重建后者前先检查它们。用于测试访问是否恢复的生成任务如果被接受,可能产生费用;本文未执行此类测试。只继续执行仍打算进行的工作,并记录已更正的账户和凭证。

迁移工作负载时,保留这些检查

如果这次锁定让你开始评估其他服务商,请确认对方同样能把凭据问题和资金问题区分开。在 reAPI 上,无效的密钥返回 HTTP 401 和错误码 10003,已吊销的密钥返回 10004,额度不足则返回 HTTP 402 和错误码 30001。[6] 工作进程可以通过 GET /api/v1/balance 读取其密钥所属账户的余额,而无需发起任何生成。[7]

清晰的错误码并不能代替上文的做法。保留完整响应、发生时间和失败的操作,并在充值之前确认已部署的密钥属于哪个账户。

参考资料

  1. fal-ai/fal。Issue 922:余额为正但账户被锁定,包含维护者指引的完整讨论串。检索于 2026 年 11 月 15 日。
  2. fal。Model APIs 常见问题。检索于 2026 年 11 月 15 日。
  3. fal。基于密钥的身份验证:权限、允许的模型和到期时间。检索于 2026 年 11 月 15 日。
  4. fal。安装与设置:Model API 和 Serverless 访问。检索于 2026 年 11 月 15 日。
  5. fal-ai/fal。Issue 1163:余额为正但余额耗尽导致账户再次锁定,包括维护者的解决说明。检索于 2026 年 11 月 15 日。
  6. reAPI。*错误码。*审阅于 2026 年 11 月 17 日。错误码。
  7. reAPI。*余额。*审阅于 2026 年 11 月 17 日。余额接口参考。
全部教程与指南