Saltar al contenido principal

Autenticación

Se requiere una API key válida para usar la API de Aether. Debes incluir un encabezado de autenticación en todas las solicitudes de la API.

Obtención de API Key​

Las API keys se pueden obtener desde el dashboard de Aether. Guarda tu key emitida en un lugar seguro.

Encabezado de Autenticación​

Debes incluir el siguiente encabezado en todas las solicitudes de la API:

Authorization: Bearer <api_key>

Ejemplo de cURL​

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful sunset over mountains",
    "ai_model": "GPT Image 1.5"
  }'

Respuestas de Error​

401 Unauthorized - API key inválida​

Se devuelve cuando la API key es inválida o falta.

Ejemplo de Respuesta:

{
  "detail": "Invalid API key"
}

Solución:

  • Verifica que la API key se haya copiado correctamente
  • Asegúrate de que el prefijo Bearer y el espacio estén incluidos
  • Comprueba que la API key no haya expirado

404 Not Found User​

Se devuelve cuando la API key es válida pero no se puede encontrar el usuario asociado.

Ejemplo de Respuesta:

{
  "detail": "Not Found User"
}

Solución:

  • Verifica que la API key esté vinculada a una cuenta de usuario activa
  • Comprueba el estado de la cuenta en el dashboard

Documentación Relacionada​