Autenticación

Asegura cada solicitud con un token portador usando tu clave API de EmpirioLabs

Todas las solicitudes de la API de EmpirioLabs deben incluir un token portador en la cabecera Authorization.

Formato de clave API

Las claves API usan el prefijo sk-empiriolabs-. Puedes generar hasta 50 claves API por cuenta desde el panel de control.

1Authorization: Bearer sk-empiriolabs-...

Formato de cabecera

Incluye el encabezado en cada solicitud:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer sk-empiriolabs-your_key_here"

Límites de tasas

Cada cuenta comienza con límites de tarifa por defecto:

LímiteDefault
Solicitudes por minuto50 RPM
Fichas por minuto2.000.000 TPM

Si necesitas límites más altos, envía un correo a support@empiriolabs.ai. Consulta Límites y claves API para más detalles.

Prácticas recomendadas

  • Generar claves API separadas para producción, staging y desarrollo
  • Rota las teclas de forma regular y justo después de la exposición sospechosa
  • Almacenar las claves en un gestor de secretos o plataforma de despliegue - nunca en código del lado del cliente, repositorios públicos o registros
  • Elimina las teclas no utilizadas del panel de control de inmediato

Pon a prueba tus credenciales

Una forma rápida de verificar que tu clave funciona:

$curl "https://api.empiriolabs.ai/v1/models" \
> -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Una respuesta 200 con el catálogo de modelos confirma que tu clave es válida y que tu cuenta está configurada correctamente.

Respuestas comunes de autenticación

Código de estadoSignificadoQué hacer
401 UnauthorizedEl token falta, está mal formado o no se ha encontradoVerifica el formato Authorization: Bearer sk-empiriolabs-... de cabecera y que la clave esté en tu panel de control
402 Payment RequiredLa cuenta tiene créditos insuficientesCréditos de recarga en la página de facturación del panel de control
429 Too Many RequestsLímite de velocidad superado (50 RPM por defecto)Vuelve a intentarlo con un retroceso exponencial y revisa el volumen de solicitudes