WaveSpeedAI

fal.ai 'User is locked'(Admin lock、Exhausted balance):含义及应对方法

你的 fal.ai 密钥返回 403 'User is locked. Reason: Admin lock' 或 'Exhausted balance'。了解每种原因的含义、如何解锁,以及在此期间如何保持应用正常运行。

By WaveSpeedAI3 min read

如果你的 fal.ai 请求突然以 403 失败,且响应体写着 User is locked,说明被封锁的是你的账户,而不是这次请求。重试无法解除,而且多数报告显示换新的 API 密钥也无法解除。接下来怎么做,取决于消息中给出的原因:Exhausted balance 是账单锁定,充值后应当解除;Admin lock 是 fal 一侧设置的锁定,只有 fal 支持团队才能移除。

本指南说明每种原因的含义、让账户最快解锁的步骤顺序,以及在等待期间如何让你的产品继续运行。

资料核查日期:2026 年 11 月 22 日,来源为 fal 的文档以及 GitHub 上 fal-ai/fal 仓库的公开 issue 追踪。

错误长什么样

API 返回 HTTP 403 和一个 detail 字符串。以下是公开报告中出现的三种变体:

{"detail": "User is locked. Reason: Exhausted balance. Top up your balance at fal.ai/dashboard/billing."}
{"detail": "User is locked. Reason: Admin lock. Please contact support@fal.ai."}
{"detail": "User is locked. Reason: TOP_UP."}
消息中的原因含义谁能解除
Exhausted balance账单锁定。fal 的 FAQ 写道:“When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.”你自己,通过充值。如果充值后仍然锁定,则需要 fal 支持团队。
TOP_UPfal 文档中没有说明。在报告中,它与同一账户的 Exhausted balance 消息一同出现,因此可视为同一种账单锁定。同上。
Admin lock由 fal 一侧设置的锁定。消息本身就让你联系支持团队。fal 没有公布判定标准。仅 fal 支持团队。

开始之前,有两点值得了解:

  • FAQ 说的是锁定阈值,而不是零。仪表盘上仍显示几美元,并不能证明你的余额高于你账户的阈值。
  • 同一份 FAQ 还说,采用发票结算的企业客户”are not subject to automatic locking”。如果服务不中断比按量付费的灵活性更重要,可以向 fal 询问这种方案。

另一种 403:“Access denied”

fal 返回的 403 并不都是账户锁定。如果响应体写的是访问被拒绝,或者你没有权限使用某个端点,并且没有 User is locked 字样,那么账户是正常的,只是这个密钥或这个端点不被允许。fal 的认证文档把这类 403 与 API 密钥的权限预设联系在一起。请检查失败的服务使用的是哪个密钥,以及该密钥创建时用的是什么预设。如果你这边没有任何改动,而昨天还能用的密钥突然被整个端点系列拒绝,这就属于需要向 fal 支持团队询问的问题,请附上端点 id 和完整的错误响应体。

你不是唯一遇到的人

fal-ai/fal 的 issue 追踪中,2026 年 3 月至 11 月间有超过 25 个关于账户被锁定的 issue。它们分为两类。

余额为正却被锁定。 用户报告仪表盘上显示有额度,却出现 Exhausted balance 锁定,例如 #922、#1112、#1163 和 #1269。在 #1163 中,报告者写道账户在手动解锁几分钟后又被再次锁定。

充值后不久出现 Admin lock。 多份报告描述了新账户或使用量很少的账户在首次付款后立刻被 admin 锁定,例如 #1183、#1248、#1254 和 #1281。另一份 #1061 来自一位开发者,其用量在上线前的端到端测试期间激增。

对 fal 公平地说:这些只是个别报告,并不能衡量发生的频率,而且在这些讨论中,fal 员工确认这些账户已由支持团队解锁。#1281 的报告者在发邮件的第二天就被解锁。其他报告者则说等了好几天才收到第一次回复。员工还在这些讨论中表示,GitHub 并不用于账户支持,没有人监控。

如何按顺序解锁

1. 读取原因,并停止重试

记录完整的 403 响应体。账户锁定不是暂时性故障,因此要把它从重试路径中移除。对被锁定的账户不断重试,只会堆满你的队列,并延误提醒相关人员采取行动的告警。

import requests

class AccountLocked(Exception):
    pass

def check_fal_response(resp: requests.Response) -> None:
    if resp.status_code == 403 and "User is locked" in resp.text:
        # 不可重试:通知人工处理,并切换到备用服务商。
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. 先检查账单

打开账单仪表盘,确认三件事:额度余额、没有未支付的发票、支付方式有效。如果原因是 Exhausted balance 或 TOP_UP,请充值。几分钟后再发送一次测试请求。

3. 用账户邮箱给支持团队发邮件

如果原因是 Admin lock,或者账单锁定在充值后依然存在,fal 指定的唯一渠道是 support@fal.ai,并且员工要求你从被锁定账户的邮箱地址发信。请把他们需要的信息全部写进第一封邮件,避免来回浪费时间:

  • 账户邮箱,以及(如果你使用团队)团队名称。
  • 完整的 detail 字符串,以及第一次失败请求的时间。
  • 你最近一次充值的收据或发票编号。
  • 用一两句话说明你的产品做什么,以及用量为什么发生变化(如果有变化的话,例如上线、压力测试、新功能)。

4. 没有帮助的做法

  • 轮换 API 密钥。 锁定是针对账户的。创建了新密钥的报告者仍然得到同样的 403。
  • 开第二个账户。 如果锁定源于支付或风控审查,在同一张卡下再开一个重复账户,通常只会让审查变慢,而不是变快。
  • 每天重复发送同一封邮件。 请在已有的邮件往来中回复,让所有记录保留在同一个工单里。
  • 提交 GitHub issue 来代替发邮件。 这可以增加曝光,但员工会关闭这类 issue 并引导你改发邮件。

如果你是团队:用一个账户,而不是每人一个账户

社区提问中常见的一种做法是:公司给每位员工开一个个人账户,并用同一张卡为所有账户充值。许多新账户由同一张卡付款,恰恰是任何平台的支付风控系统都会重点留意的情形。fal 文档中给出的做法是使用团队:一个拥有独立账单的共享工作区,其中”API keys belong to the team, not to individual members”,管理员可以通过邮箱邀请成员,人数较多时可以通过 CSV 批量邀请。如果你的账户已经因此被锁定,请在支持邮件中坦率说明,并请求合并为一个团队。

等待期间让你的产品继续运行

账户锁定是重试、退避和第二个 API 密钥都无法解决的一类故障。如果付费客户依赖你的生成流程,切实可行的保护措施是准备第二个平台:它提供相同的模型系列,已经集成并充好值,你可以用一个配置开关切换过去。

几条规则可以让维护成本很低:

  • 把模型选择放在你自己的接口之后,让调用方请求的是”文生图,1024 × 1024”,而不是某个服务商的 URL。
  • 把账户级错误(被锁定、被停用、额度用尽)与请求级错误分开归类,只对前一类触发故障切换。
  • 每天让一小部分真实流量经过备用通道。一个一个月都没被调用过的备用方案,到你需要时往往已经坏了。

把 WaveSpeedAI 用作第二平台

WaveSpeedAI 是一个按量付费的 API,提供图像、视频、音频和 3D 模型。模型目录涵盖了大多数 fal 项目所用的模型系列,包括 Seedance、Kling、Wan、Veo、FLUX、Seedream 和 GPT Image。与这个问题相关的要点如下:

  • 每次请求都会检查额度。 当账户有足够的额度时,请求即被接受。充值之后,下一次请求就能通过,不存在需要额外等待的单独解锁步骤。
  • 额度用尽时有明确提示。 API 会返回 Insufficient credits. Please top up your account to continue,因此你的代码可以区分账单问题与模型故障。
  • 自动充值。 你可以让账户在余额低于你设定的数值时自动充值,从而消除凌晨 3 点宕机最常见的原因。
  • 支付方式。 银行卡、PayPal、支付宝和微信支付。
  • 团队成员共用一个账户。 在仪表盘中邀请队友,让所有人使用同一份余额,而不是各自拥有单独的个人账户。
  • 运行前显示价格。 每个模型页面都会显示你所配置请求的费用。

和所有平台一样,WaveSpeedAI 也有使用条款和内容规则,因此在迁移生产流量之前请先阅读。

请求长什么样

先提交一个任务,再用返回的 id 获取结果。示例使用的是一个快速的文生图模型;目录中的每个模型都遵循同样的两次调用。

curl --request POST 'https://api.wavespeed.ai/api/v3/wavespeed-ai/z-image/turbo' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A lighthouse on a cliff at sunrise, soft fog, 35mm photo"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

第一次调用返回 data.id。第二次调用返回 data.status(created、processing、completed 或 failed),完成后,文件 URL 位于 data.outputs 中。

从 fal 迁移的对应关系

在 fal 上在 WaveSpeedAI 上
提交到某个模型的队列端点POST https://api.wavespeed.ai/api/v3/<model path>
轮询请求状态,然后获取结果GET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Authorization: Key ... 请求头Authorization: Bearer ... 请求头
完成时的 Webhook支持;参见文档
Python 和 JavaScript 客户端Python 和 JavaScript SDK,以及原生 REST

部分模型的输入参数名称在不同平台之间并不相同,因此请查看每个模型页面上的参数列表,而不要直接把请求体照搬过去。

如果你想在写代码之前先在浏览器中测试,图像生成器和视频生成器运行的模型与 API 相同。

常见问题

fal.ai 上的 “User is locked. Reason: Admin lock” 是什么意思?

意思是该账户是被 fal 一侧锁定的,而不是被自动余额检查锁定的。消息要求你联系 support@fal.ai。充值或创建新密钥都无法解除,必须由 fal 支持团队处理。

为什么我的 fal 账户明明还有额度,却因 “Exhausted balance” 被锁定?

fal 的 FAQ 说,当余额降到账户特定的锁定阈值以下时就会触发锁定,而这个阈值不一定是零。另外,也有一些公开报告描述了充值成功后锁定依然存在的情况,这些情况下是支持团队手动解除的。先充值,等几分钟,测试一次,然后给支持团队发邮件。

fal 解锁一个账户需要多久?

没有公布的时限。在公开讨论中,有些用户在发邮件后一天内就被解锁,也有人说等了好几天才收到第一次回复。请按较长的情况做好规划。

为什么 fal 会返回 “Access denied” 或 “You do not have permission to use this endpoint”?

这是权限错误,不是账户锁定。请检查该请求所用 API 密钥的权限预设。如果密钥和你的代码都没有变化,请把端点 id 和错误响应体发给 fal 支持团队。

同一张卡下的多个 fal 账户会被锁定吗?

fal 没有公布其风控规则。一般来说,许多账户由同一张卡充值,是触发支付风险检查的常见原因,而 fal 提供了团队功能,可让多人共用一个账单账户,因此请使用团队。

新的 API 密钥或新账户能解决问题吗?

新密钥不能,因为锁定针对的是账户。第一个账户还在审查期间,新开账户并不是个好主意。

如何避免任何平台上的账户锁定导致停机?

保持第二个服务商已集成并已充值,把账户级错误视为不可重试,并在遇到这类错误时自动切换。在平台提供自动充值的情况下将其开启,这样低余额就永远不会演变成锁定。

分享