WaveSpeedAI

fal.ai «User is locked» (Admin lock, Exhausted balance): что это значит и что делать

Ваш ключ fal.ai возвращает 403 «User is locked. Reason: Admin lock» или «Exhausted balance». Что означает каждая причина, как снять блокировку и как сохранить работу приложения в это время.

By WaveSpeedAI10 min read

Если ваши запросы к fal.ai внезапно завершаются ошибкой 403 с телом User is locked, блокировка наложена на ваш аккаунт, а не на сам запрос. Повторные попытки её не снимут, и, судя по большинству сообщений, новый API-ключ тоже не помогает. Что делать дальше, зависит от причины в сообщении: Exhausted balance — это блокировка по биллингу, которую должно снять пополнение баланса, а Admin lock — блокировка со стороны fal, которую может снять только поддержка fal.

В этом руководстве разобрано, что означает каждая причина, в каком порядке действовать, чтобы быстрее разблокировать аккаунт, и как сохранить работоспособность продукта на время ожидания.

Источники проверены 22 ноября 2026 года: документация fal и публичный трекер задач репозитория fal-ai/fal на GitHub.

Как выглядит ошибка

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Блокировка по биллингу. В FAQ fal сказано: «When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.»Вы сами, пополнив баланс. Если после пополнения аккаунт остаётся заблокированным — поддержка fal.
TOP_UPВ документации fal не описана. В сообщениях пользователей она появляется рядом с Exhausted balance на одном и том же аккаунте, поэтому считайте её той же блокировкой по биллингу.То же, что выше.
Admin lockБлокировка, установленная на стороне fal. Само сообщение предлагает обратиться в поддержку. Критерии fal не публикует.Только поддержка fal.

Прежде чем начать, стоит знать две вещи:

  • В FAQ говорится о пороге блокировки, а не о нуле. Если в панели ещё отображаются несколько долларов, это не доказывает, что вы выше порога для вашего аккаунта.
  • Там же сказано, что корпоративные клиенты с оплатой по счёту «are not subject to automatic locking». Если непрерывная работа для вас важнее гибкости оплаты по факту использования, о таком тарифе стоит спросить у fal.

Другая ошибка 403: «Access denied»

Не каждая ошибка 403 от fal означает блокировку аккаунта. Если в теле написано, что доступ запрещён или что у вас нет разрешения на использование эндпоинта, а текста User is locked нет, то аккаунт открыт, но этому ключу или этому эндпоинту доступ не разрешён. Документация fal по аутентификации связывает такие 403 с пресетом разрешений API-ключа. Проверьте, какой ключ использует сбойный сервис и с каким пресетом он был создан. Если на вашей стороне ничего не менялось, а целое семейство эндпоинтов вдруг стало отклонять ключ, который работал вчера, — это вопрос к поддержке fal. Приложите идентификатор эндпоинта и полное тело ошибки.

Вы не одиноки

В трекере задач fal-ai/fal более 25 обращений о заблокированных аккаунтах, открытых с марта по ноябрь 2026 года. Их можно разделить на две группы.

Блокировка при положительном балансе. Пользователи сообщают о блокировке Exhausted balance, хотя в панели видны кредиты, например #922, #1112, #1163 и #1269. В #1163 автор пишет, что аккаунт снова заблокировался через несколько минут после ручной разблокировки.

Admin lock вскоре после пополнения. Несколько сообщений описывают, как новый или малоиспользуемый аккаунт получал admin lock сразу после первого платежа, например #1183, #1248, #1254 и #1281. Другое, #1061, написал разработчик, у которого потребление резко выросло во время сквозного тестирования перед запуском.

Справедливости ради: это отдельные сообщения, а не оценка частоты таких случаев, и в обсуждениях сотрудники 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 вместо письма. Это может добавить заметности, но сотрудники закрывают такие задачи и перенаправляют на электронную почту.

Если вы команда: один аккаунт, а не по аккаунту на человека

В вопросах сообщества часто встречается такая схема: компания заводит каждому сотруднику личный аккаунт и пополняет все их одной и той же картой. Множество новых аккаунтов, оплачиваемых с одной карты, — именно то, что системы платёжных рисков на любой платформе созданы замечать. Задокументированный способ fal для таких случаев — команда: общее рабочее пространство с собственным биллингом, где «API keys belong to the team, not to individual members», а администраторы приглашают участников по электронной почте или по CSV для больших групп. Если ваши аккаунты уже были заблокированы таким образом, прямо сообщите об этом в письме в поддержку и попросите объединить их в одну команду.

Как не остановить продукт на время ожидания

Блокировка аккаунта — единственный сбой, который не исправят ни повторы, ни backoff, ни второй API-ключ. Если от вашего конвейера генерации зависят платящие клиенты, практичная защита — вторая платформа с теми же семействами моделей, уже интегрированная и пополненная, на которую можно переключиться флагом конфигурации.

Несколько правил делают её поддержку недорогой:

  • Держите выбор модели за собственным интерфейсом, чтобы вызывающий код запрашивал «text to image, 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, Alipay и WeChat Pay.
  • Участники команды на одном аккаунте. Приглашайте коллег из панели управления, чтобы все работали с одного баланса, а не с отдельных личных аккаунтов.
  • Цена видна до запуска. На странице каждой модели показана стоимость настроенного вами запроса.

Как и у любой платформы, у WaveSpeedAI есть условия использования и правила для контента, поэтому прочитайте их, прежде чем переводить рабочий трафик.

Как выглядит запрос

Отправьте задачу, затем получите результат по возвращённому идентификатору. В примере используется быстрая модель text-to-image; все модели каталога работают через те же два вызова.

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/<путь модели>
Опрос статуса запроса, затем получение результатаGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Заголовок Authorization: Key ...Заголовок Authorization: Bearer ...
Webhook по завершенииПоддерживается; см. документацию
Клиенты для Python и JavaScriptSDK для Python и JavaScript, а также обычный REST

У некоторых моделей названия входных параметров на разных платформах отличаются, поэтому сверяйтесь со списком параметров на странице каждой модели, а не копируйте полезную нагрузку из одной платформы в другую.

Если вы хотите сначала попробовать в браузере, не написав ни строки кода, генератор изображений и генератор видео запускают те же модели, что и API.

FAQ

Что означает «User is locked. Reason: Admin lock» в fal.ai?

Это значит, что аккаунт заблокирован самой fal, а не автоматической проверкой баланса. В сообщении предлагается обратиться на support@fal.ai. Пополнение кредитов или создание нового ключа блокировку не снимает; это должна сделать поддержка fal.

Почему мой аккаунт fal заблокирован с «Exhausted balance», если у меня ещё есть кредиты?

В FAQ fal сказано, что блокировка срабатывает, когда баланс опускается ниже порога блокировки, индивидуального для аккаунта, который не обязательно равен нулю. Кроме того, ряд публичных сообщений описывает блокировку, сохранившуюся после успешного пополнения, и в таких случаях поддержка снимала её вручную. Пополните баланс, подождите несколько минут, проверьте одним запросом, затем напишите в поддержку.

Сколько времени fal разблокирует аккаунт?

Опубликованных сроков нет. В публичных обсуждениях одних пользователей разблокировали в течение суток после письма, а другие сообщают, что ждали первого ответа несколько дней. Рассчитывайте на более долгий вариант.

Почему fal возвращает «Access denied» или «You do not have permission to use this endpoint»?

Это ошибка разрешений, а не блокировка аккаунта. Проверьте пресет разрешений API-ключа, использованного в запросе. Если ни ключ, ни ваш код не менялись, отправьте в поддержку fal идентификатор эндпоинта и тело ошибки.

Могут ли заблокировать несколько аккаунтов fal, оплаченных одной картой?

fal не публикует свои правила оценки рисков. Множество аккаунтов, пополняемых одной картой, вообще считается типичным поводом для проверок платёжных рисков, а для совместного использования одного биллингового аккаунта несколькими людьми у fal есть команды, так что используйте команду.

Поможет ли новый API-ключ или новый аккаунт?

Новый ключ не поможет, потому что блокировка наложена на аккаунт. Новый аккаунт — плохая идея, пока первый находится на проверке.

Как избежать простоя из-за блокировки аккаунта на любой платформе?

Держите второго провайдера интегрированным и пополненным, считайте ошибки уровня аккаунта не подлежащими повтору и автоматически переключайтесь при них на резерв. Включайте автопополнение там, где платформа его предлагает, чтобы низкий баланс никогда не превращался в блокировку.

Поделиться