Skip to main content
This guide walks you through generating your first AI image using Lumenfall’s API.

​
Prerequisites

​
Generate an image

Lumenfall uses an OpenAI-compatible API, so you can use any OpenAI SDK or make direct HTTP requests. 
curl https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3-pro-image",
    "prompt": "A serene mountain landscape at sunset with dramatic clouds",
    "n": 1,
    "size": "1024x1024"
  }'

​
Response

The API returns image URLs in the standard OpenAI format: 
{
  "created": 1702345678,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

​
Available models

Lumenfall routes your requests to the best available provider. Browse our full model catalog to see all supported models, or use the Models API to list available models programmatically.

​
Estimate costs before generating

Add ?dryRun=true to any request to get a cost estimate without generating the image. The response includes pricing in micros (1/1,000,000 of a dollar). See Cost estimation for details and response format.

​
Next steps

API Reference

Explore the full API documentation.

Authentication

Learn about API keys and authentication.

Routing

Understand how Lumenfall routes requests to providers.

Billing

View pricing and manage your account balance.