Saltar al contenido
UlazAI

Documentos para desarrolladores UlazAI

Errores y límites

Precios Panel estudio de imagen

Manejo de errores y límites de la plataforma

Utilice un manejo estructurado para los errores API y valide las entradas del lado del cliente para reducir reintentos.

Respuestas HTTP comunes

Código Significado Causa típica
400 Solicitud no válida Falta prompt, tamaño no admitido, parámetros de modelo no válidos
401 No autorizado Clave/token de sesión API faltante o no válido
402 Pago requerido Créditos comprados insuficientes o restricción de acceso API
403 prohibido Los puntos finales de registro/inicio de sesión API están deshabilitados intencionalmente
404 No encontrado El ID de generación no pertenece al usuario actual o no coincide el punto final
500 error del servidor Fallo del proveedor ascendente o tiempo de espera de la red

Solicitar límites para hacer cumplir del lado del cliente

  • prompt: máximo 5000 caracteres en un punto final unificado.
  • image_urls: máximo 14 URL en un punto final unificado.
  • size: específico del modelo, validar contra matriz modelo.
  • quality: valores específicos del modelo para Seedream 5 Lite, Nano Banana 2, Ideogram y Qwen.
  • El uso de API requiere la compra de créditos; Los créditos de bienvenida son solo para el sitio web.

Estrategia de reintento

Comportamiento de producción recomendado:

  • no lo vuelvas a intentar 400, 401, 402, o 403 sin cambiar la entrada o la autenticación.
  • Reintentar 500 con retroceso exponencial e codificación de idempotencia en su capa de aplicación.
  • Sondear el punto final del estado antes de iniciar trabajos de generación duplicados.