· reAPI Team
Error fal User is locked: revisa cuenta, clave y saldo
Diagnostica el error fal User is locked comprobando la respuesta, la cuenta, los créditos y los permisos de la clave. Prepara pruebas para soporte antes de reintentar o pagar más.

User is locked puede seguir apareciendo después de recargar saldo. En el issue público 922 de fal, varios usuarios describieron esa discrepancia: el panel mostraba crédito, pero las solicitudes seguían recibiendo una respuesta de bloqueo. El hilo contiene distintos arreglos y fallos comunicados; finalmente, su responsable indicó a los usuarios afectados que acudieran al soporte específico de su cuenta.[1]
Ese historial no determina la causa de tu error. Sí explica por qué «añade más dinero» o «crea otra clave» es una respuesta incompleta. Empieza por consultar el motivo completo que devuelve la API, la cuenta que hay detrás de la aplicación en ejecución y la hora en que se produjo el error. Pausa los envíos automáticos de la aplicación mientras esos datos no estén claros.
Conserva el texto que aparece después de «Reason»
No combines en una misma entrada de registro un mensaje de saldo agotado y otro de bloqueo administrativo. Conserva el cuerpo completo de la respuesta, con su estado HTTP, endpoint, método y marca de tiempo. Un registro que solo conserva 403 ha descartado información que necesitarás para decidir qué hacer después.
A continuación, identifica qué operación falló. ¿La aplicación estaba enviando una nueva generación, comprobando una solicitud ya aceptada o intentando recuperar su resultado? Una excepción del SDK que aparece al final de un flujo de trabajo puede proceder de cualquiera de esos pasos. La solución depende del paso que realmente recibió el rechazo.
Considera esta secuencia hipotética: el envío devuelve un ID de solicitud, el worker lo guarda y una consulta posterior recibe el error de bloqueo. Esa secuencia no demuestra que la generación anterior fallara o se cancelara. Conserva el ID y las respuestas de ambas operaciones. Repetir todo el flujo crearía un nuevo envío sin aclarar el resultado de la solicitud existente.
En cambio, si se rechazó el envío inicial y no llegó ningún ID de solicitud, registra ese resultado concreto. No inventes un identificador de tarea ni asignes un estado final de generación a partir del mensaje de autorización. Estás investigando si se permitió la operación, todavía no evaluando la calidad del contenido generado.
La guía de fal sobre estados completados explica el caso distinto en el que una solicitud conocida llega a un estado terminal, pero falta su contenido. Distinguir estos casos evita que un problema de cuenta provoque una regeneración innecesaria.
Comprueba la cuenta antes de interpretar el saldo
Las preguntas frecuentes de fal indican que las cuentas se bloquean cuando su saldo cae por debajo del umbral de bloqueo de la cuenta. Para ese caso recomienda añadir crédito y trata por separado la facturación empresarial mediante factura.[2] Esta regla no afirma universalmente que cualquier cantidad positiva mostrada garantice el acceso a todas las cuentas.
Primero, relaciona la cuenta propietaria de la clave de la aplicación con la cuenta seleccionada en el panel. Incluye el contexto del equipo cuando corresponda. El navegador puede mostrar un equipo con fondos mientras un worker usa una clave personal; es una posibilidad que conviene comprobar durante el diagnóstico, no una explicación que hayamos establecido para tu solicitud.
Inspecciona la configuración del proceso en ejecución mediante tus herramientas habituales de gestión de secretos. El nombre de la clave o un identificador seguro pueden ayudar a confirmar su origen sin imprimir el secreto. Si alguien cambió hace poco la credencial, verifica que el despliegue realmente cargó la configuración prevista. Actualizar un archivo de entorno local no demuestra qué está usando otro worker.
Compara la observación del saldo y el error en momentos conocidos. Por ejemplo, una captura de pantalla tomada antes de recargar saldo no permite saber si este había cambiado cuando falló la solicitud posterior. Anota juntos la hora del recibo, la hora de la captura del panel y la hora de la operación fallida. Así soporte podrá revisar una secuencia en vez de dos capturas sin fecha.
Si el saldo de la cuenta afectada y el motivo devuelto coinciden con el umbral de financiación documentado, sigue esas indicaciones de facturación. Si falta una compra completada, investiga el registro de compra y crédito. Si la cuenta correcta muestra crédito, pero el bloqueo sigue sin explicación, otro depósito no demuestra que el problema vaya a resolverse.
Iniciar sesión en el panel también es una operación distinta del acceso a la API. Si no puedes iniciar sesión con GitHub porque nunca llega el código de un solo uso, las preguntas frecuentes de fal recomiendan comprobar el correo electrónico principal de la cuenta de GitHub.[2] Eso puede ayudarte a acceder a la página de la cuenta, pero no explica por qué una aplicación ya configurada recibe una respuesta de bloqueo de cuenta.
Una cuenta con fondos aún puede tener una política de clave incorrecta
fal documenta ajustes preestablecidos de permisos, listas de permisos personalizadas, restricciones de modelos permitidos y caducidad de claves. Su ajuste preestablecido de API está pensado para consumir modelos alojados.[3] Esos controles determinan qué puede hacer la credencial. El saldo indica qué fondos hay disponibles. Corregir uno no confirma el otro.
Compara la operación exacta que falló con la política de la clave. Si la clave está limitada a ciertos modelos, comprueba que el endpoint previsto cumpla esa restricción. Si ha caducado, corrige la credencial en vez de añadir crédito. Si un cliente está enviando una clave distinta de la esperada, corrige esa configuración antes de cambiar los permisos de la cuenta.
Un detalle que puede pasar desapercibido es cómo se creó la política. fal dice que una clave preestablecida sigue la definición actual del ajuste, mientras que una política personalizada conserva la lista de permisos desde su creación. Añadir una restricción de modelo guarda la clave como política personalizada.[3] Por eso, puede ser necesario revisar por separado dos claves creadas para la misma aplicación, en vez de dar por hecho que sus permisos siguen siendo idénticos.
No concedas acceso completo a todas las claves solo para ver si cambia el error. Autoriza las operaciones que necesita la aplicación y conserva la política anterior en tus notas de investigación. Si una solicitud tiene éxito después de varios cambios simultáneos, no sabrás cuál fue importante y podrías dejar un acceso más amplio del que requiere la aplicación.
Del mismo modo, sustituir una clave no es una operación universal documentada para desbloquear una cuenta. En el issue 922, algunos usuarios comunicaron que tuvieron éxito después de crear una clave nueva o actualizar el SDK, mientras que otros dijeron que esos pasos no funcionaron.[1] Son observaciones individuales. No demuestran que la versión del SDK, la migración de una clave o un desbloqueo tardío sean la causa de todos los mensajes similares.
Al comparar dos clientes, primero haz coincidir la cuenta, el modelo y la operación previstos. Una solicitud correcta para un modelo desde un portátil no demuestra que un worker programado pueda acceder a otro modelo. Anota la diferencia restante antes de elegir una corrección. De lo contrario, un cambio de modelo o cuenta puede confundirse con una solución de la biblioteca cliente.
Revisa la versión instalada del cliente y cómo se construye la solicitud si las pruebas apuntan en esa dirección. Conserva la respuesta completa del servicio antes de cambiar paquetes. Así podrás distinguir una corrección de configuración del cliente de una restricción de cuenta que requiere la atención del proveedor.
Los modelos alojados y los despliegues Serverless requieren comprobaciones distintas
Si solo llamas a las Model APIs alojadas de fal, la guía de instalación indica que necesitas una clave API y el SDK del cliente, no la CLI de Serverless. Desplegar tus propias aplicaciones Serverless requiere la aprobación de la cuenta; llamar a las Model APIs alojadas no requiere esa aprobación.[4]
Esto importa cuando un resultado de búsqueda te dirige a instalar la CLI o cambiar de equipo. Confirma que esos pasos correspondan al producto y al proceso que reciben el error. Que un perfil de la CLI funcione no determina, por sí solo, qué credencial usa tu servicio web desplegado por separado.
Para las aplicaciones de navegador, fal recomienda mantener la clave detrás de un proxy del lado del servidor.[2] Poner el secreto en el código del navegador no soluciona un bloqueo de cuenta. Comprueba la credencial real del proxy y el error devuelto, manteniendo la autenticación en el servidor.
Proporciona a soporte una cuenta y una secuencia que investigar
Ante un bloqueo sin explicación, la indicación del responsable es contactar con el soporte de fal usando el mismo correo electrónico que la cuenta afectada. Los casos de bloqueo se tratan individualmente; un comentario en un issue público no puede desbloquearla.[1]
Un informe privado y conciso puede seguir este formato:
Cuenta: [cuenta afectada]. A las [hora UTC], [operación y endpoint] devolvió [error completo con datos sensibles eliminados]. La aplicación usa [identificador seguro de credencial] perteneciente a [cuenta o equipo]. A las [hora de captura], esa cuenta mostraba [saldo]. La compra [referencia], si corresponde, se registró a las [hora]. La solicitud [ID], si existe, se aceptó antes del error posterior. Revisad la restricción de la cuenta y la operación que se muestra aquí.
Añade el nombre y la versión del cliente e indica qué comprobaciones ya has completado. Elimina la cabecera de autorización, la clave API y los datos de pago innecesarios. Describe las observaciones con claridad: la clave utilizada, la respuesta recibida y el saldo mostrado. No atribuyas a esos registros un fallo de base de datos ni una motivación de facturación que no demuestren.
Lee la respuesta más reciente del responsable en cualquier issue que uses como contexto. Otro informe, el issue 1163, se cerró después de que un responsable dijera que soporte ya había resuelto esa cuenta anteriormente.[5] Eso no demuestra que todas las cuentas estén arregladas, igual que el informe original no demuestra que la interrupción siga ocurriendo ahora. No se puede deducir de ninguno de los dos hilos un plazo de espera universal ni una promesa de reembolso.
Si soporte dice que la cuenta está desbloqueada, vuelve a la operación que falló. En el caso hipotético de un trabajo aceptado seguido de una consulta rechazada, comprueba primero esa solicitud existente. Es posible que el acceso restablecido te permita recuperar su estado; no garantiza que la generación haya tenido éxito. Guarda la respuesta nueva junto al mensaje de bloqueo anterior. Si la misma operación sigue fallando, envía la marca de tiempo actualizada y la respuesta en la conversación de soporte existente para que la revisión corresponda al estado actual de la cuenta.
Cuando recuperes el acceso, revisa el trabajo pausado antes de reanudarlo. Separa los envíos rechazados de los trabajos que ya recibieron ID e inspecciona estos últimos antes de volver a crearlos. Una generación usada para probar el acceso restablecido puede generar un cargo si se acepta; este artículo no ha ejecutado esa prueba. Reanuda solo el trabajo que todavía quieras realizar y deja constancia de la cuenta y la credencial corregidas.
Mantén estas comprobaciones si cambias de proveedor
Si el bloqueo te lleva a evaluar otro proveedor, comprueba que también separe los problemas de credenciales de los de saldo. En reAPI, una clave no válida devuelve HTTP 401 con el código 10003, una clave revocada devuelve 10004 y el crédito insuficiente devuelve HTTP 402 con el código 30001.[6] Un worker puede consultar el saldo de la cuenta asociada a su clave con GET /api/v1/balance sin iniciar ninguna generación.[7]
Los códigos claros no sustituyen los hábitos anteriores. Conserva la respuesta completa, la hora y la operación que falló, y confirma a qué cuenta pertenece la clave desplegada antes de añadir crédito.
Referencias
- fal-ai/fal. Issue 922: cuenta bloqueada pese a tener saldo positivo, hilo completo con las indicaciones del responsable. Consultado el 15 de noviembre de 2026.
- fal. Preguntas frecuentes sobre Model APIs. Consultado el 15 de noviembre de 2026.
- fal. Autenticación mediante claves: permisos, modelos permitidos y caducidad. Consultado el 15 de noviembre de 2026.
- fal. Instalación y configuración: acceso a Model APIs y Serverless. Consultado el 15 de noviembre de 2026.
- fal-ai/fal. Issue 1163: la cuenta vuelve a bloquearse por saldo agotado pese a tener saldo positivo, incluida la resolución del responsable. Consultado el 15 de noviembre de 2026.
- reAPI. Errores. Revisado el 17 de noviembre de 2026. Códigos de error.
- reAPI. Saldo. Revisado el 17 de noviembre de 2026. Referencia del saldo.