Códigos de error

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:

  1. ¿Está la Key copiada completamente (empieza con sk-, sin espacios)
  2. ¿Ha sido eliminada? Confírmalo en Gestión de API Key
  3. ¿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:

  1. ¿Coincide el nombre exactamente con el catálogo de modelos (sensible a mayúsculas)
  2. ¿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.