Image API

Generate and edit images

Use GPT Image 2, Nano Banana 2, and Nano Banana Pro through one request format.

Get started

Mode

text-to-image

Start a generation with a prompt and output settings.

References

image-to-image

Provide one or more image URLs within the selected model's limits.

Output

resolution / format

Choose aspect ratio, resolution, file format, and output count.

Create endpoint

POSThttps://api.mlmux.com/v1/images/generations

Request example

curl https://api.mlmux.com/v1/images/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "route_mode": "official-cheap",
    "prompt": "Editorial product photography",
    "resolution": "2K"
  }'

Route mode

Every model supports the same three route tiers: official, official-cheap, and mix. New requests default to official-cheap. A request stays within the selected tier and never silently crosses into another tier.

officialDirect official-provider route

official-cheapLower-cost official route · default

mixMixed upstream pool for price and capacity

Prediction response

idUnique task identifier

statusqueued, running, succeeded, or failed

outputCompleted media URLs

usageCredits, units, and final charge