Skip to main content

​
Overview

Antigravity Manager supports Imagen 3 image generation through multiple API formats, providing flexibility for different use cases and client applications.

​
Supported Formats

Use the standard OpenAI images endpoint: 
import openai

client = openai.OpenAI(
    api_key="sk-antigravity",
    base_url="http://127.0.0.1:8045/v1"
)

response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="A futuristic city with neon lights, cyberpunk style",
    size="1920x1080",      # Any WIDTHxHEIGHT format
    quality="hd",          # "standard" | "hd" | "medium"
    n=1,
    response_format="b64_json"
)

# Save image
import base64
image_data = base64.b64decode(response.data[0].b64_json)
with open("output.png", "wb") as f:
    f.write(image_data)

​
Chat API with Parameters

Generate images through the chat completions endpoint: 
# OpenAI Chat API
response = client.chat.completions.create(
    model="gemini-3-pro-image",
    size="1920x1080",      # Any WIDTHxHEIGHT format
    quality="hd",          # "standard" | "hd" | "medium" 
    messages=[{"role": "user", "content": "A futuristic city"}]
)

# Claude Messages API
curl -X POST http://127.0.0.1:8045/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-antigravity" \
  -d '{
    "model": "gemini-3-pro-image",
    "size": "1280x720",
    "quality": "hd",
    "messages": [{"role": "user", "content": "A cute cat"}]
  }'

​
Model Suffix Method

Embed parameters in the model name: 
response = client.chat.completions.create(
    model="gemini-3-pro-image-16-9-4k",  # Format: model-[ratio]-[quality]
    messages=[{"role": "user", "content": "A futuristic city"}]
)

​
Size Parameters

​
Standard Sizes

Supported aspect ratios and resolutions: 
size="1024x1024"  # Standard
quality="hd"      # 4K resolution

​
Custom Dimensions

Any WIDTHxHEIGHT format is supported and automatically mapped to standard ratios: 
# Custom sizes - automatically calculated
size="2560x1440"  # Maps to 16:9
size="3840x2160"  # Maps to 16:9 (4K)
size="1600x1200"  # Maps to 4:3
The system calculates the aspect ratio and maps to the nearest standard format.

​
Quality Settings

​
Quality Levels

quality="standard"  # Default resolution (1K)
quality="medium"    # 2K resolution
quality="hd"        # 4K resolution

​
Advanced: imageSize Parameter

Direct resolution control using Gemini’s native parameter: 
response = client.chat.completions.create(
    model="gemini-3-pro-image",
    size="16:9",       # Aspect ratio
    imageSize="4K",    # Direct resolution: "1K" | "2K" | "4K"
    messages=[{"role": "user", "content": "A futuristic city"}]
)
imageSize has the highest priority and overrides quality if both are specified.

​
Parameter Priority

imageSize parameter > quality parameter > model suffix

​
Model Suffix Combinations

Embed all parameters in the model name: 
// Format: gemini-3-pro-image-[ratio]-[quality]
"gemini-3-pro-image-16-9"      // 16:9 standard
"gemini-3-pro-image-16-9-4k"   // 16:9 4K
"gemini-3-pro-image-9-16-2k"   // 9:16 2K
"gemini-3-pro-image-4-3"       // 4:3 standard
"gemini-3-pro-image-1-1-4k"    // 1:1 4K

​
Response Formats

​
Base64 JSON (Default)

response_format="b64_json"

# Decode and save
import base64
image_data = base64.b64decode(response.data[0].b64_json)
with open("image.png", "wb") as f:
    f.write(image_data)

​
Data URI

response_format="url"

# Response contains data URI
data_uri = response.data[0].url
# Format: data:image/png;base64,iVBORw0KGgo...

​
Batch Generation

Generate multiple images in one request: 
response = client.images.generate(
    model="gemini-3-pro-image",
    prompt="A futuristic city",
    n=4,  # Generate 4 images (max 10)
    size="1024x1024"
)

for i, image in enumerate(response.data):
    image_data = base64.b64decode(image.b64_json)
    with open(f"image_{i}.png", "wb") as f:
        f.write(image_data)
Generating multiple images consumes quota proportionally (4 images = 4x quota usage).

​
Client Integration

​
Cherry Studio

Configure image generation in Cherry Studio:
1

Open Model Settings

Navigate to Settings → Models and select gemini-3-pro-image.
2

Configure Parameters

Set the following in model settings:
  • Size: Enter any WIDTHxHEIGHT format (e.g., 1920x1080)
  • Quality: Choose standard, hd, or medium
  • Number: Set generation count (1-10)
3

Generate Images

Simply send your image description in the chat.

​
Using Model Config UI

Some clients support model-level configuration: 
{
  "model": "gemini-3-pro-image",
  "default_params": {
    "size": "1920x1080",
    "quality": "hd",
    "n": 1
  }
}

​
Quota Tracking

Image generation quota is tracked separately: 
// From src/pages/Dashboard.tsx:52
const geminiImageQuotas = accounts
  .map(a => a.quota?.models.find(m =>
    m.name.toLowerCase() === 'gemini-3.1-flash-image' ||
    m.name.toLowerCase() === 'gemini-3-pro-image'
  )?.percentage || 0)
  .filter(q => q > 0);

const avgGeminiImage = geminiImageQuotas.length > 0
  ? Math.round(geminiImageQuotas.reduce((a, b) => a + b, 0) / geminiImageQuotas.length)
  : 0;

​
Real-time Quota Updates

Quota is refreshed immediately after generation: 
// Automatic quota sync after image generation
if image_generation_successful {
    tokio::spawn(async move {
        let _ = refresh_quota_for_account(&account_id).await;
    });
}

​
Advanced Options

​
Aspect Ratio Mapping

The system automatically maps custom sizes to standard ratios: 
fn calculate_aspect_ratio(width: u32, height: u32) -> String {
    let ratio = width as f64 / height as f64;
    
    if (ratio - 21.0/9.0).abs() < 0.1 { "21:9" }
    else if (ratio - 16.0/9.0).abs() < 0.1 { "16:9" }
    else if (ratio - 4.0/3.0).abs() < 0.1 { "4:3" }
    else if (ratio - 3.0/4.0).abs() < 0.1 { "3:4" }
    else if (ratio - 9.0/16.0).abs() < 0.1 { "9:16" }
    else { "1:1" }
}

​
Size Validation

# Automatic size parsing and validation
def parse_size(size_str: str) -> tuple:
    try:
        width, height = size_str.split('x')
        return (int(width), int(height))
    except:
        return (1024, 1024)  # Default fallback

​
Error Handling

​
Common Errors

# Error: Invalid size format
size="invalid"

# Solution: Use WIDTHxHEIGHT
size="1920x1080"

​
Best Practices

  1. Use Standard Sizes: Stick to common resolutions for best results
  2. Monitor Quota: Track image generation quota separately from text
  3. Quality vs. Quota: Balance quality settings with quota consumption
  4. Batch Wisely: Generate multiple variations when needed
  5. Cache Results: Store generated images to avoid regeneration

Build docs developers (and LLMs) love

Get started for freeTalk to us