WaveSpeedAI

fal.ai 'User is locked' (Admin lock, Exhausted balance): qué significa y qué hacer

Tu clave de fal.ai devuelve 403 'User is locked. Reason: Admin lock' o 'Exhausted balance'. Qué significa cada motivo, cómo desbloquear tu cuenta y cómo mantener tu app funcionando mientras tanto.

By WaveSpeedAI12 min read

Si tus solicitudes a fal.ai empiezan a fallar de repente con 403 y el cuerpo dice User is locked, el bloqueo está en tu cuenta, no en tu solicitud. Reintentar no lo eliminará y, según la mayoría de los reportes, una nueva clave de API tampoco. Lo que debes hacer a continuación depende del motivo indicado en el mensaje: Exhausted balance es un bloqueo de facturación que una recarga debería levantar, y Admin lock es un bloqueo colocado por fal que solo el soporte de fal puede retirar.

Esta guía explica qué significa cada motivo, el orden de pasos que desbloquea una cuenta más rápido y cómo mantener un producto en funcionamiento mientras esperas.

Fuentes consultadas el 22 de noviembre de 2026: la documentación de fal y el rastreador público de incidencias del repositorio fal-ai/fal en GitHub.

Cómo se ve el error

La API responde con HTTP 403 y una cadena detail. Estas son las tres variantes que aparecen en los reportes 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 en el mensajeQué significaQuién puede eliminarlo
Exhausted balanceBloqueo de facturación. En las preguntas frecuentes de fal se lee: “When your credit balance drops below your account’s lock threshold, your account is locked and API requests will be rejected” (cuando tu saldo de créditos cae por debajo del umbral de bloqueo de tu cuenta, esta se bloquea y las solicitudes a la API son rechazadas).Tú, añadiendo créditos. Si sigue bloqueada tras la recarga, el soporte de fal.
TOP_UPNo se describe en la documentación de fal. En los reportes aparece junto al mensaje Exhausted balance en la misma cuenta, así que trátalo como el mismo bloqueo de facturación.Igual que arriba.
Admin lockUn bloqueo establecido por fal. El propio mensaje te indica que contactes con soporte. fal no publica los criterios.Solo el soporte de fal.

Conviene conocer dos detalles antes de empezar:

  • Las preguntas frecuentes hablan de un umbral de bloqueo, no de cero. Un panel que todavía muestra unos pocos dólares no demuestra que estés por encima del umbral de tu cuenta.
  • Las mismas preguntas frecuentes indican que los clientes empresariales con facturación por factura “are not subject to automatic locking” (no están sujetos al bloqueo automático). Si el servicio ininterrumpido te importa más que la flexibilidad del pago por uso, ese es el plan por el que debes preguntar a fal.

Otro 403 distinto: “Access denied”

No todos los 403 de fal son un bloqueo de cuenta. Si el cuerpo dice que el acceso está denegado o que no tienes permiso para usar un endpoint, y no aparece el texto User is locked, la cuenta está abierta pero esta clave o este endpoint no están permitidos. La documentación de autenticación de fal vincula los 403 de este tipo con el preajuste de permisos de la clave de API. Comprueba qué clave usa el servicio que falla y con qué preajuste se creó. Si no ha cambiado nada por tu parte y toda una familia de endpoints empezó a rechazar una clave que funcionaba ayer, es una consulta para el soporte de fal, con el id del endpoint y el cuerpo completo del error.

No eres el único

El rastreador de incidencias de fal-ai/fal tiene más de 25 incidencias sobre cuentas bloqueadas abiertas entre marzo y noviembre de 2026. Se dividen en dos grupos.

Bloqueo con saldo positivo. Los usuarios reportan el bloqueo Exhausted balance mientras el panel muestra créditos, por ejemplo #922, #1112, #1163 y #1269. En #1163 el autor escribe que la cuenta se volvió a bloquear minutos después de un desbloqueo manual.

Admin lock poco después de una recarga. Varios reportes describen una cuenta nueva o poco usada que recibe un Admin lock justo después de su primer pago, por ejemplo #1183, #1248, #1254 y #1281. Otro, #1061, provino de un desarrollador cuyo uso se disparó durante las pruebas de extremo a extremo antes de un lanzamiento.

Para ser justos con fal: se trata de reportes individuales, no de una medida de la frecuencia con que ocurre, y en los hilos el personal de fal confirma que el soporte desbloqueó las cuentas. El autor de #1281 fue desbloqueado al día siguiente de enviar un correo. Otros autores dicen que esperaron varios días para recibir una primera respuesta. El personal también afirma en esos hilos que GitHub no se supervisa para el soporte de cuentas.

Cómo desbloquearte, en orden

1. Lee el motivo y deja de reintentar

Registra el cuerpo completo del 403. Una cuenta bloqueada no es un fallo transitorio, así que sácala de tu ruta de reintentos. Reintentar con una cuenta bloqueada solo llena tu cola y retrasa la alerta de que alguien debe actuar.

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. Revisa primero la facturación

Abre el panel de facturación y confirma tres cosas: el saldo de créditos, que no haya ninguna factura impagada y que el método de pago sea válido. Si el motivo es Exhausted balance o TOP_UP, añade créditos. Después, envía una solicitud de prueba unos minutos más tarde.

3. Escribe al soporte desde la dirección de la cuenta

Si el motivo es Admin lock, o un bloqueo de facturación persiste tras una recarga, el único canal que fal nombra es support@fal.ai, y el personal pide que escribas desde la dirección de correo de la cuenta bloqueada. Incluye todo lo que necesitan en el primer mensaje para no perder ninguna ida y vuelta:

  • El correo de la cuenta y, si usas uno, el nombre del equipo.
  • La cadena detail exacta y la hora de la primera solicitud fallida.
  • El recibo o el número de factura de tu última recarga.
  • Una o dos frases sobre qué hace tu producto y por qué cambió el uso, si cambió (un lanzamiento, una prueba de carga, una nueva función).

4. Lo que no ayuda

  • Rotar la clave de API. El bloqueo está en la cuenta. Los autores que crearon una clave nueva obtuvieron el mismo 403.
  • Abrir una segunda cuenta. Si el bloqueo se debe a una revisión de pagos o de riesgo, una cuenta duplicada con la misma tarjeta suele hacer la revisión más lenta, no más rápida.
  • Enviar el mismo correo cada día. Responde en el hilo existente, de modo que el historial quede en un solo ticket.
  • Abrir una incidencia en GitHub en lugar de enviar un correo. Puede aumentar la visibilidad, pero el personal las cierra y redirige al correo.

Si eres un equipo: una cuenta, no una cuenta por persona

Un patrón que aparece en las preguntas de la comunidad es el de una empresa que da a cada empleado una cuenta personal y las financia todas con la misma tarjeta. Muchas cuentas nuevas pagadas desde una sola tarjeta es exactamente lo que los sistemas de riesgo de pagos están diseñados para detectar, en cualquier plataforma. La forma documentada por fal de hacerlo es un equipo: un espacio de trabajo compartido con su propia facturación, donde “API keys belong to the team, not to individual members” (las claves de API pertenecen al equipo, no a los miembros individuales) y los administradores invitan a los miembros por correo o por CSV para grupos más grandes. Si tus cuentas ya se bloquearon de esta manera, dilo claramente en el correo a soporte y pide consolidarlas en un solo equipo.

Mantén tu producto en funcionamiento mientras esperas

Un bloqueo de cuenta es el único fallo que los reintentos, el backoff y una segunda clave de API no pueden arreglar. Si clientes que pagan dependen de tu pipeline de generación, la protección práctica es una segunda plataforma que ofrezca las mismas familias de modelos, ya integrada y con fondos, a la que puedas cambiar con una bandera de configuración.

Unas pocas reglas hacen que mantenerla sea barato:

  • Mantén la elección del modelo detrás de tu propia interfaz, de modo que quien llama pida “texto a imagen, 1024 × 1024” y no una URL de un proveedor.
  • Clasifica los errores a nivel de cuenta (bloqueada, suspendida, sin créditos) por separado de los errores a nivel de solicitud, y conmuta al respaldo solo con el primer tipo.
  • Envía cada día una pequeña parte del tráfico real por el respaldo. Un respaldo que no se ha invocado en un mes suele estar roto cuando lo necesitas.

Usar WaveSpeedAI como segunda plataforma

WaveSpeedAI es una API de pago por uso para modelos de imagen, vídeo, audio y 3D. El catálogo de modelos cubre las familias que usan la mayoría de los proyectos de fal, incluidas Seedance, Kling, Wan, Veo, FLUX, Seedream y GPT Image. Los puntos que importan para este problema:

  • Los créditos se comprueban en cada solicitud. Una solicitud se acepta cuando la cuenta tiene créditos suficientes para ella. Después de recargar, la siguiente solicitud se procesa; no hay un paso de desbloqueo aparte que esperar.
  • Un mensaje claro cuando se acaban los créditos. La API devuelve Insufficient credits. Please top up your account to continue, de modo que tu código puede distinguir un problema de facturación de un fallo del modelo.
  • Recarga automática. Puedes dejar que la cuenta se recargue sola por debajo de un saldo que elijas, lo que elimina la causa más común de una caída a las 3 de la madrugada.
  • Opciones de pago. Tarjetas, PayPal, Alipay y WeChat Pay.
  • Miembros del equipo en una sola cuenta. Invita a tus compañeros desde el panel para que todos trabajen con el mismo saldo en lugar de cuentas personales separadas.
  • Precio visible antes de ejecutar. Cada página de modelo muestra el coste de la solicitud que configuraste.

Como cualquier plataforma, WaveSpeedAI tiene términos de uso y normas de contenido, así que léelos antes de mover tráfico de producción.

Cómo es una solicitud

Envía una tarea y luego obtén el resultado con el id devuelto. El ejemplo usa un modelo rápido de texto a imagen; todos los modelos del catálogo siguen las mismas dos llamadas.

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"

La primera llamada devuelve data.id. La segunda devuelve data.status (created, processing, completed o failed) y, cuando se completa, las URL de los archivos en data.outputs.

Equivalencias con fal

En falEn WaveSpeedAI
Enviar al endpoint de cola de un modeloPOST https://api.wavespeed.ai/api/v3/<model path>
Consultar el estado de la solicitud y luego obtener el resultadoGET https://api.wavespeed.ai/api/v3/predictions/<id>/result
Cabecera Authorization: Key ...Cabecera Authorization: Bearer ...
Webhook al completarseCompatible; consulta la documentación
Clientes de Python y JavaScriptSDK de Python y JavaScript, además de REST simple

Los nombres de los parámetros de entrada difieren entre plataformas en algunos modelos, así que revisa la lista de parámetros en cada página de modelo en lugar de copiar un payload de una a otra.

Si prefieres probar en un navegador antes de escribir código, el generador de imágenes y el generador de vídeo ejecutan los mismos modelos que la API.

Preguntas frecuentes

¿Qué significa “User is locked. Reason: Admin lock” en fal.ai?

Significa que la cuenta fue bloqueada por fal y no por la comprobación automática de saldo. El mensaje te pide contactar con support@fal.ai. Añadir créditos o crear una nueva clave no lo levanta; tiene que hacerlo el soporte de fal.

¿Por qué mi cuenta de fal está bloqueada con “Exhausted balance” si todavía tengo créditos?

Las preguntas frecuentes de fal dicen que el bloqueo se activa cuando el saldo cae por debajo de un umbral de bloqueo específico de la cuenta, que no es necesariamente cero. Por otra parte, varios reportes públicos describen que el bloqueo persiste tras una recarga exitosa, y en esos casos el soporte lo levantó manualmente. Recarga, espera unos minutos, prueba una vez y luego escribe al soporte.

¿Cuánto tarda fal en desbloquear una cuenta?

No hay un plazo publicado. En los hilos públicos, algunos usuarios fueron desbloqueados en el plazo de un día tras enviar el correo y otros cuentan que esperaron varios días para una primera respuesta. Planifica para el caso más largo.

¿Por qué fal devuelve “Access denied” o “You do not have permission to use this endpoint”?

Es un error de permisos, no un bloqueo de cuenta. Comprueba el preajuste de permisos de la clave de API que usó la solicitud. Si ni la clave ni tu código cambiaron, envía al soporte de fal el id del endpoint y el cuerpo del error.

¿Pueden bloquearse varias cuentas de fal con una misma tarjeta?

fal no publica sus reglas de riesgo. Muchas cuentas financiadas por una sola tarjeta son un desencadenante común de las comprobaciones de riesgo de pagos en general, y fal ofrece equipos para compartir una cuenta de facturación entre varias personas, así que usa un equipo.

¿Arreglará esto una nueva clave de API o una cuenta nueva?

Una nueva clave no, porque el bloqueo está en la cuenta. Una cuenta nueva es una mala idea mientras la primera esté en revisión.

¿Cómo evito la inactividad por un bloqueo de cuenta en cualquier plataforma?

Mantén un segundo proveedor integrado y con fondos, trata los errores a nivel de cuenta como no reintentables y conmuta automáticamente ante ellos. Activa la recarga automática donde la plataforma la ofrezca, para que un saldo bajo nunca se convierta en un bloqueo.

Compartir