Skip to main content
POST
Image Generation

Request

string
required
Authorization: Bearer nb_YOUR_API_KEY
string
required
Image model slug. See Image Models.Popular options: dall-e-3, flux-1.1-pro, midjourney-v6, midjourney-turbo, sd-3.5-large
string
required
Text description of the image to generate.
string
What to exclude from the image. Supported by Flux, SD, Midjourney models.
string
default:"1024x1024"
Image dimensions. Available options depend on the model:
string
default:"webp"
Output format: webp, png, jpeg
string
default:"standard"
Quality preset: standard or hd. Affects cost on DALL-E 3 and GPT Image.
string
Style hint for compatible models (vivid or natural for DALL-E 3).
integer
Random seed for reproducible results. Pass the same seed with the same prompt to get similar outputs.
string
Input image URL for image-to-image generation (supported by Flux Kontext, SD Inpaint).

Request Example

Response

integer
Unique generation ID.
string
completed | pending | failed
string
Direct URL to the generated image. Files are stored for the duration matching your plan (Free: 7 days, Basic: 30 days, Pro/VIP: 90 days, Elite: unlimited).
integer
Elumenta tokens consumed.
integer
The seed used (useful if you didn’t specify one and want to reproduce the result).

Response Example

Async Generation (MidJourney)

MidJourney returns status: "pending" initially. Poll until complete:
Then poll: GET /api/v2/generate/{id} See Generation Status for details.

Non-square Pricing Note

DALL-E 3 and GPT Image 1.5 charge more for non-square aspect ratios (e.g. 1024×1792 costs up to 2× more). Use the Calculate Price endpoint to check exact token cost before generating.