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 может продолжать появляться и после пополнения счёта. В публичном issue 922 fal пользователи описали это несоответствие: на панели отображались средства, но запросы по-прежнему получали ответ о блокировке. В обсуждении приведены разные сообщения об исправлениях и неудачах; в итоге сопровождающий направил пострадавших пользователей в службу поддержки по конкретному аккаунту.[1]

Эта история не устанавливает причину твоей ошибки. Но она объясняет, почему «внести ещё денег» или «создать ещё один ключ» — неполный ответ. Для начала выясни полный текст причины, возвращённой API, аккаунт, используемый работающим приложением, и время возникновения ошибки. Пока эти факты не выяснены, приостанови автоматические отправки приложения.

Сохрани текст после «Reason»

Не объединяй сообщение об исчерпанном балансе и сообщение об административной блокировке в одну запись журнала. Сохрани полное тело ответа вместе с HTTP-статусом, конечной точкой, методом и временной меткой. Если в журнале остался только 403, значит, потеряна информация, нужная для следующего решения.

Затем выясни, какая операция завершилась ошибкой. Приложение отправляло новую генерацию, проверяло уже принятую заявку или пыталось получить её результат? Исключение SDK, отображаемое в конце рабочего процесса, могло возникнуть на любом из этих этапов. Способ устранения зависит от этапа, на котором действительно пришёл отказ.

Рассмотрим гипотетическую последовательность: отправка возвращает ID запроса, рабочий процесс сохраняет его, а при более позднем опросе приходит ошибка блокировки. Эта последовательность не доказывает, что предыдущая генерация завершилась ошибкой или была отменена. Сохрани ID и ответы для обеих операций. Повторный запуск всего рабочего процесса создаст новую отправку, не выяснив исход существующего запроса.

Напротив, если первоначальную отправку отклонили и ID запроса не пришёл, зафиксируй именно этот результат. Не выдумывай идентификатор задачи и не назначай генерации итоговый статус на основании сообщения авторизации. Ты выясняешь, была ли разрешена операция, а не оцениваешь качество сгенерированных медиафайлов.

В руководстве fal по завершённым статусам рассматривается отдельный случай: известный запрос достигает конечного состояния, но медиафайл отсутствует. Разделение этих случаев помогает не допустить ненужной повторной генерации из-за проблемы с аккаунтом.

Проверь аккаунт, прежде чем толковать баланс

В FAQ fal говорится, что аккаунты блокируются, когда баланс опускается ниже порога блокировки аккаунта. Для такого случая рекомендуется пополнить счёт, а выставление счетов корпоративным клиентам рассматривается отдельно.[2] Это правило не означает, что любая отображаемая положительная сумма гарантирует доступ для каждого аккаунта.

Сначала сопоставь аккаунт, которому принадлежит ключ приложения, с аккаунтом, выбранным на панели. Если нужно, укажи также контекст команды. В браузере может отображаться команда с пополненным балансом, а рабочий процесс использует личный ключ; это возможный вариант для проверки при поиске неисправности, но не установленное объяснение твоего запроса.

Проверь конфигурацию работающего процесса с помощью обычных инструментов управления секретами. Название ключа или безопасный идентификатор помогут подтвердить источник, не выводя секрет. Если кто-то недавно изменил учётные данные, убедись, что развёртывание действительно загрузило нужную конфигурацию. Обновление локального файла окружения не показывает, что использует отдельный рабочий процесс.

Сравни наблюдение баланса и ошибку по известным временным отметкам. Например, снимок экрана, сделанный до пополнения, не покажет, изменился ли баланс к моменту более позднего сбоя запроса. Запиши вместе время получения квитанции, время снимка панели и время неудачной операции. Так у поддержки будет последовательность событий для проверки, а не два снимка экрана без дат.

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

Вход в панель — тоже отдельная операция, не связанная с доступом к API. Если тебе не удаётся войти через GitHub, потому что одноразовый код так и не приходит, в FAQ fal рекомендуется проверить основной адрес электронной почты аккаунта GitHub.[2] Это может помочь открыть страницу аккаунта, но не объясняет, почему уже настроенное приложение получает ответ о блокировке аккаунта.

Даже на пополненном аккаунте может быть неверная политика ключа

В документации fal описаны готовые наборы разрешений, пользовательские списки разрешений, ограничения по допустимым моделям и срок действия ключа. Набор API предназначен для использования размещённых моделей.[3] Эти параметры определяют, что могут делать учётные данные. Баланс показывает имеющиеся средства. Исправление одного не подтверждает правильность другого.

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

Можно упустить из виду, как была создана политика. По словам fal, ключ с готовым набором следует текущему определению этого набора, а пользовательская политика сохраняет список разрешений, заданный при создании. При добавлении ограничения по модели ключ сохраняется как пользовательская политика.[3] Поэтому два ключа, созданные для одного приложения, могут требовать отдельной проверки: не следует предполагать, что их разрешения остаются одинаковыми.

Не предоставляй каждому ключу полный доступ только ради проверки, изменится ли ошибка. Разреши операции, необходимые приложению, и сохрани прежнюю политику в заметках расследования. Если запрос успешно пройдёт после нескольких одновременных изменений, ты не поймёшь, какое из них повлияло на результат, а доступ может оказаться шире, чем нужно приложению.

Кроме того, замена ключа не является задокументированной универсальной операцией разблокировки аккаунта. В issue 922 одни пользователи сообщали об успехе после создания нового ключа или обновления SDK, а другие говорили, что эти шаги не помогли.[1] Это отдельные наблюдения. Они не доказывают, что причиной каждого похожего сообщения является версия SDK, перенос ключа или задержка разблокировки.

Сравнивая два клиента, сначала приведи к совпадению нужные аккаунт, модель и операцию. Успешный запрос одной модели с ноутбука не подтверждает доступ к другой модели из запланированного рабочего процесса. Запиши оставшиеся различия, прежде чем выбирать исправление. Иначе изменение модели или аккаунта можно принять за исправление библиотеки клиента.

Если данные указывают на клиент, проверь установленную версию клиента и формирование запроса. Перед изменением пакетов сохрани полный ответ сервиса. Это позволит отличить исправление конфигурации клиента от ограничения аккаунта, требующего внимания поставщика.

Для размещённых моделей и развёртывания Serverless нужны разные проверки

Если ты вызываешь только размещённые Model APIs fal, в руководстве по установке сказано, что нужны API-ключ и клиентский SDK, но не Serverless CLI. Для развёртывания собственных приложений Serverless требуется одобрение аккаунта; для вызова размещённых Model APIs такое одобрение не нужно.[4]

Это важно, когда результат поиска направляет тебя к установке CLI или переключению команды. Убедись, что эти шаги относятся к продукту и процессу, где возникла ошибка. Рабочий профиль CLI сам по себе не показывает, какие учётные данные использует отдельно развёрнутый веб-сервис.

Для браузерных приложений 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: аккаунт заблокирован, несмотря на положительный баланс, полное обсуждение, включая рекомендации сопровождающего. Дата обращения: 15 ноября 2026 г.
  2. fal. FAQ по Model APIs. Дата обращения: 15 ноября 2026 г.
  3. fal. Аутентификация по ключу: разрешения, допустимые модели и срок действия. Дата обращения: 15 ноября 2026 г.
  4. fal. Установка и настройка: доступ к Model APIs и Serverless. Дата обращения: 15 ноября 2026 г.
  5. fal-ai/fal. Issue 1163: аккаунт повторно блокируется из-за исчерпанного баланса, несмотря на положительный остаток, включая решение сопровождающего. Дата обращения: 15 ноября 2026 г.
  6. reAPI. Ошибки. Проверено 17 ноября 2026 года. Коды ошибок.
  7. reAPI. Баланс. Проверено 17 ноября 2026 года. Справка по балансу.
Все руководства