AI Model Values

Describes the available AI models in the Aether API and the characteristics of each model.

AiModelType Enumeration

List of AI models available for image generation requests.

Model Value	Description
GPT Image 1.5	OpenAI GPT Image 1.5 model (deprecated)
GPT Image 2	OpenAI GPT Image 2 model
GPT Image 2.5 High	OpenAI GPT Image 2.5 High model
GPT Image 2.5 XHigh	OpenAI GPT Image 2.5 XHigh model
Grok Imagine	xAI Grok Imagine model (deprecated)
Grok Imagine Pro	xAI Grok Imagine Pro model (deprecated)
Nano Banana	Nano Banana model (deprecated)
Nano Banana 2	Nano Banana 2 model (deprecated)
Nano Banana Pro	Nano Banana Pro model

Reference Image Limits

Each model has a different maximum number of images allowed in the ref_images parameter.

Model	Maximum Reference Images
GPT Image 1.5	10
GPT Image 2	10
GPT Image 2.5 High	10
GPT Image 2.5 XHigh	10
Grok Imagine	5
Grok Imagine Pro	1
Nano Banana	10
Nano Banana 2	10
Nano Banana Pro	10

Request Examples

Basic Generation

curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-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"
}'

With Reference Images (Grok Imagine Pro)

curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-H "Authorization: Bearer your_api_key_here" \
-F "prompt=A cat in the style of the reference image" \
-F "ai_model=Grok Imagine Pro" \
-F "[email protected]"

With Reference Images (GPT Image 1.5 - up to 10)

curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-H "Authorization: Bearer your_api_key_here" \
-F "prompt=A landscape combining these styles" \
-F "ai_model=GPT Image 1.5" \
-F "[email protected]" \
-F "[email protected]" \
-F "[email protected]"

Error Responses

400 Bad Request - Reference Image Limit Exceeded

Returned when the maximum number of reference images for a model is exceeded.

Grok Imagine Pro Example:

{
  "detail": "The Grok Imagine Pro model supports up to 1 ref_images."
}

General Limit Example:

{
  "detail": "ref_images supports up to 10 images only"
}

Model Selection Guide

Use Case	Recommended Model
High-quality general image generation	GPT Image 2.5 High / GPT Image 2.5 XHigh
When style references are needed	Grok Imagine (up to 5)
High-quality results with single reference image	Grok Imagine Pro
When multiple reference images are needed	Nano Banana series (up to 10)

Related Documentation

• POST /public/v1/generate/image - Image generation endpoint
• Asynchronous Job Lifecycle - Job processing flow