Skip to main content

Authentication

A valid API key is required to use the Aether API. You must include an authentication header in all API requests.

Obtaining an API Key​

API keys can be obtained from the Aether Dashboard. Store your issued key in a secure location.

Authentication Header​

Include the following header in all API requests:

Authorization: Bearer <api_key>

cURL Example​

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"
}'

Error Responses​

401 Unauthorized - Invalid API key​

Returned when the API key is invalid or missing.

Response Example:

{
  "detail": "Invalid API key"
}

Resolution:

  • Verify that the API key was copied correctly
  • Ensure the Bearer prefix and space are included
  • Check that the API key has not expired

404 Not Found User​

Returned when the API key is valid but the associated user cannot be found.

Response Example:

{
  "detail": "Not Found User"
}

Resolution:

  • Verify that the API key is linked to an active user account
  • Check the account status in the dashboard