WaveSpeedAI

fal.ai 'User is locked' (Admin lock, Exhausted balance): O que significa e o que fazer

Sua chave fal.ai retorna 403 'User is locked. Reason: Admin lock' ou 'Exhausted balance'. O que cada motivo significa, como ser desbloqueado e como manter seu app funcionando enquanto isso.

By WaveSpeedAI12 min read

Se as suas requisições à fal.ai começarem a falhar de repente com 403 e o corpo da resposta disser User is locked, o bloqueio está na sua conta, não na requisição. Tentar de novo não resolve e, na maioria dos relatos, uma nova chave de API também não. O que fazer a seguir depende do motivo indicado na mensagem: Exhausted balance é um bloqueio de cobrança que uma recarga deve remover, e Admin lock é um bloqueio aplicado pela própria fal que só o suporte da fal pode remover.

Este guia explica o que cada motivo significa, a ordem de passos que desbloqueia uma conta mais rápido e como manter um produto funcionando enquanto você espera.

Fontes consultadas em 22 de novembro de 2026: a documentação da fal e o rastreador público de issues do repositório fal-ai/fal no GitHub.

Como o erro aparece

A API responde com HTTP 403 e uma string detail. Estas são as três variantes que aparecem em relatos públicos:

{"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."}
Motivo na mensagemO que significaQuem pode remover
Exhausted balanceBloqueio de cobrança. O FAQ da fal diz: “When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected.”Você, adicionando créditos. Se continuar bloqueada após a recarga, o suporte da fal.
TOP_UPNão é descrito na documentação da fal. Nos relatos, aparece junto da mensagem Exhausted balance na mesma conta, então trate-o como o mesmo bloqueio de cobrança.O mesmo que acima.
Admin lockUm bloqueio definido pela fal. A própria mensagem manda você entrar em contato com o suporte. A fal não publica os critérios.Somente o suporte da fal.

Dois detalhes que vale a pena saber antes de começar:

  • O FAQ fala de um limite de bloqueio, não de zero. Um painel que ainda mostra alguns dólares não prova que você está acima do limite da sua conta.
  • O mesmo FAQ diz que clientes enterprise com cobrança por fatura “are not subject to automatic locking”. Se o serviço ininterrupto importa mais do que a flexibilidade do pagamento conforme o uso, esse é o plano sobre o qual perguntar à fal.

Outro 403: “Access denied”

Nem todo 403 da fal é um bloqueio de conta. Se o corpo disser que o acesso foi negado ou que você não tem permissão para usar um endpoint, e não houver o texto User is locked, a conta está aberta, mas esta chave ou este endpoint não é permitido. A documentação de autenticação da fal associa 403s desse tipo ao preset de permissões da chave de API. Verifique qual chave o serviço com falha usa e com qual preset ela foi criada. Se nada mudou do seu lado e uma família inteira de endpoints passou a recusar uma chave que funcionava ontem, isso é uma pergunta para o suporte da fal, com o id do endpoint e o corpo completo do erro.

Você não é o único

O rastreador de issues do fal-ai/fal tem mais de 25 issues sobre contas bloqueadas abertas entre março e novembro de 2026. Elas se dividem em dois grupos.

Bloqueio com saldo positivo. Usuários relatam o bloqueio Exhausted balance enquanto o painel mostra créditos, por exemplo #922, #1112, #1163 e #1269. Na #1163, o autor escreve que a conta foi bloqueada de novo minutos depois de um desbloqueio manual.

Admin lock logo após uma recarga. Vários relatos descrevem uma conta nova ou pouco usada sendo bloqueada por admin logo após o primeiro pagamento, por exemplo #1183, #1248, #1254 e #1281. Outro, o #1061, veio de um desenvolvedor cujo uso disparou durante testes de ponta a ponta antes de um lançamento.

Para ser justo com a fal: são relatos individuais, não uma medida da frequência com que isso acontece, e nas discussões a equipe da fal confirma que as contas foram desbloqueadas pelo suporte. O autor da #1281 foi desbloqueado no dia seguinte ao envio do e-mail. Outros autores dizem ter esperado vários dias por uma primeira resposta. A equipe também afirma nessas discussões que o GitHub não é monitorado para suporte de contas.

Como ser desbloqueado, em ordem

1. Leia o motivo e pare de tentar de novo

Registre o corpo completo do 403. Uma conta bloqueada não é uma falha transitória, então tire-a do seu fluxo de retentativas. Tentar de novo numa conta bloqueada só enche a sua fila e atrasa o alerta de que alguém precisa agir.

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:
        # Not retryable: page a human and switch to the fallback provider.
        raise AccountLocked(resp.json().get("detail", resp.text))
    resp.raise_for_status()

2. Verifique primeiro a cobrança

Abra o painel de cobrança e confirme três coisas: o saldo de créditos, que não há fatura em aberto e que a forma de pagamento é válida. Se o motivo for Exhausted balance ou TOP_UP, adicione créditos. Depois envie uma requisição de teste alguns minutos mais tarde.

3. Escreva ao suporte a partir do e-mail da conta

Se o motivo for Admin lock, ou se um bloqueio de cobrança persistir após a recarga, o único canal que a fal indica é support@fal.ai, e a equipe pede que você escreva a partir do endereço de e-mail da conta bloqueada. Coloque tudo o que eles precisam na primeira mensagem para não desperdiçar nenhuma ida e volta:

  • O e-mail da conta e, se você usar um, o nome da equipe.
  • A string detail exata e o horário da primeira requisição com falha.
  • O recibo ou o número da fatura da sua última recarga.
  • Uma ou duas frases sobre o que o seu produto faz e por que o uso mudou, se mudou (um lançamento, um teste de carga, um novo recurso).

4. O que não ajuda

  • Trocar a chave de API. O bloqueio está na conta. Quem criou uma chave nova recebeu o mesmo 403.
  • Abrir uma segunda conta. Se o bloqueio for uma revisão de pagamento ou de risco, uma conta duplicada no mesmo cartão geralmente deixa a revisão mais lenta, não mais rápida.
  • Enviar o mesmo e-mail todos os dias. Responda na conversa existente, para que o histórico fique em um único ticket.
  • Abrir uma issue no GitHub em vez de enviar e-mail. Pode dar mais visibilidade, mas a equipe fecha essas issues e redireciona para o e-mail.

Se você é uma equipe: uma conta, não uma conta por pessoa

Um padrão que aparece em perguntas da comunidade é uma empresa dar a cada funcionário uma conta pessoal e financiar todas com o mesmo cartão. Muitas contas novas pagas por um único cartão é exatamente o que os sistemas de risco de pagamento são feitos para notar, em qualquer plataforma. A forma documentada pela fal de fazer isso é uma equipe: um espaço de trabalho compartilhado com cobrança própria, em que “API keys belong to the team, not to individual members” e os administradores convidam membros por e-mail, ou por CSV para grupos maiores. Se as suas contas já foram bloqueadas dessa forma, diga isso com clareza no e-mail ao suporte e peça para consolidá-las em uma única equipe.

Mantenha o seu produto funcionando enquanto espera

Um bloqueio de conta é a única falha que retentativas, backoff e uma segunda chave de API não resolvem. Se clientes pagantes dependem do seu pipeline de geração, a proteção prática é uma segunda plataforma que atenda às mesmas famílias de modelos, já integrada e com saldo, para a qual você possa mudar com uma flag de configuração.

Algumas regras tornam isso barato de manter:

  • Mantenha a escolha do modelo atrás da sua própria interface, de modo que quem chama peça “texto para imagem, 1024 × 1024” e não uma URL de fornecedor.
  • Classifique os erros de nível de conta (bloqueada, suspensa, sem créditos) separadamente dos erros de nível de requisição, e faça failover apenas no primeiro tipo.
  • Envie todos os dias uma pequena parcela do tráfego real pelo fallback. Um fallback que não é chamado há um mês costuma estar quebrado quando você precisa dele.

Usando a WaveSpeedAI como segunda plataforma

A WaveSpeedAI é uma API de pagamento conforme o uso para modelos de imagem, vídeo, áudio e 3D. O catálogo de modelos cobre as famílias que a maioria dos projetos na fal usa, incluindo Seedance, Kling, Wan, Veo, FLUX, Seedream e GPT Image. Os pontos que importam para este problema:

  • Os créditos são verificados a cada requisição. Uma requisição é aceita quando a conta tem créditos suficientes para ela. Depois que você recarrega, a próxima requisição passa; não há uma etapa de desbloqueio separada para esperar.
  • Uma mensagem clara quando os créditos acabam. A API retorna Insufficient credits. Please top up your account to continue, para que o seu código distinga um problema de cobrança de uma falha de modelo.
  • Recarga automática. Você pode deixar a conta se recarregar sozinha quando o saldo ficar abaixo de um valor que você escolher, o que elimina a causa mais comum de uma queda às 3 da manhã.
  • Formas de pagamento. Cartões, PayPal, Alipay e WeChat Pay.
  • Membros da equipe em uma só conta. Convide colegas pelo painel para que todos trabalhem com o mesmo saldo, em vez de contas pessoais separadas.
  • Preço mostrado antes de executar. Cada página de modelo mostra o custo da requisição que você configurou.

Como toda plataforma, a WaveSpeedAI tem termos de uso e regras de conteúdo, então leia-os antes de migrar o tráfego de produção.

Como é uma requisição

Envie uma tarefa e depois busque o resultado com o id retornado. O exemplo usa um modelo rápido de texto para imagem; todos os modelos do catálogo seguem as mesmas duas chamadas.

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"

A primeira chamada retorna data.id. A segunda retorna data.status (created, processing, completed ou failed) e, quando concluída, as URLs dos arquivos em data.outputs.

Equivalência com a fal

Na falNa WaveSpeedAI
Enviar para o endpoint de fila de um modeloPOST https://api.wavespeed.ai/api/v3/<model path>
Consultar o status da requisição e depois buscar o resultadoGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Cabeçalho Authorization: Key ...Cabeçalho Authorization: Bearer ...
Webhook na conclusãoSuportado; veja a documentação
Clientes Python e JavaScriptSDKs Python e JavaScript, além de REST puro

Os nomes dos campos de entrada diferem entre plataformas em alguns modelos, então confira a lista de parâmetros na página de cada modelo em vez de copiar um payload de uma plataforma para outra.

Se você prefere testar no navegador antes de escrever código, o gerador de imagens e o gerador de vídeos executam os mesmos modelos que a API.

FAQ

O que significa “User is locked. Reason: Admin lock” na fal.ai?

Significa que a conta foi bloqueada pela própria fal, e não pela verificação automática de saldo. A mensagem pede que você entre em contato com support@fal.ai. Adicionar créditos ou criar uma nova chave não remove o bloqueio; o suporte da fal precisa fazê-lo.

Por que a minha conta da fal está bloqueada com “Exhausted balance” se ainda tenho créditos?

O FAQ da fal diz que o bloqueio é acionado quando o saldo cai abaixo de um limite de bloqueio específico da conta, que não é necessariamente zero. Além disso, vários relatos públicos descrevem o bloqueio permanecendo após uma recarga bem-sucedida e, nesses casos, o suporte o removeu manualmente. Recarregue, espere alguns minutos, teste uma vez e depois escreva ao suporte.

Quanto tempo a fal leva para desbloquear uma conta?

Não há prazo publicado. Nas discussões públicas, alguns usuários foram desbloqueados em até um dia depois de enviar o e-mail e outros relatam ter esperado vários dias por uma primeira resposta. Planeje-se para o caso mais longo.

Por que a fal retorna “Access denied” ou “You do not have permission to use this endpoint”?

Isso é um erro de permissão, não um bloqueio de conta. Verifique o preset de permissões da chave de API usada pela requisição. Se a chave e o seu código não mudaram, envie ao suporte da fal o id do endpoint e o corpo do erro.

Várias contas da fal no mesmo cartão podem ser bloqueadas?

A fal não publica as suas regras de risco. Muitas contas financiadas por um único cartão são, em geral, um gatilho comum para verificações de risco de pagamento, e a fal oferece equipes para compartilhar uma única conta de cobrança entre várias pessoas, então use uma equipe.

Uma nova chave de API ou uma nova conta resolve?

Uma nova chave não resolve, porque o bloqueio está na conta. Uma nova conta é uma má ideia enquanto a primeira está em revisão.

Como evito paradas por causa de um bloqueio de conta em qualquer plataforma?

Mantenha um segundo provedor integrado e com saldo, trate os erros de nível de conta como não repetíveis e faça failover automático neles. Ative a recarga automática onde a plataforma a oferecer, para que um saldo baixo nunca se torne um bloqueio.

Compartilhar