Códigos de error
Cuando encuentres errores al llamar a la API o usar el sitio web, consulta esta referencia.
401 Unauthorized
Significado: API Key inválida.
Verificar:
- ¿Está la Key copiada completamente (empieza con
sk-, sin espacios) - ¿Ha sido eliminada? Confírmalo en Gestión de API Key
- ¿Está activa la variable de entorno? (reabre la terminal)
403 Forbidden
Significado: sin permiso para acceder al recurso.
Verificar: la Key puede estar deshabilitada o la IP restringida. Revisa el estado en Gestión de API Key.
404 Not Found
Significado: modelo no encontrado o ruta incorrecta.
Verificar:
- ¿Coincide el nombre exactamente con el catálogo de modelos (sensible a mayúsculas)
- ¿Incluye la Base URL el sufijo
/v1
429 Too Many Requests
Significado: demasiadas solicitudes — se activó el límite de velocidad.
Solución: espera unos segundos y reintenta; en escenarios de alta frecuencia, añade lógica de reintento en el código.
Saldo insuficiente
Significado: el saldo de tu cuenta no es suficiente para esta llamada.
Solución: recarga en la página de recarga.
500 / 502 / 503
Significado: error temporal del servidor.
Solución: reintenta más tarde. Si persiste, envía un ticket por Mis formularios.