GPT Image 2.6 API: Flare vs Sunburst, price per image and working code

export REVANA_API_KEY="sr_live_..."

# One Idempotency-Key per job, made once: resend with the same $KEY after a timeout, a 429 or a 5xx
KEY=$(uuidgen)

# 1. Submit the job (returns 202 with the generation id). max_cost_usd is your cap: the most it may cost.
curl https://api.revana.si/v1/generations \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "input": {
      "prompt": "A minimalist concert poster. A single red guitar pick on cream paper, long soft shadow. Top: \"NIGHT SHIFT\" in bold condensed black letters. Bottom: \"LIVE 12.12\" in small caps.",
      "resolution": "2K",
      "aspect_ratio": "2:3"
    },
    "max_cost_usd": 0.1
  }'

# 2. Poll with the id from step 1 until status is "succeeded" or "failed".
#    A failed job is free; make a new KEY before you submit it again.
curl https://api.revana.si/v1/generations/gen_01JC7P3K8D \
  -H "Authorization: Bearer $REVANA_API_KEY"

import os
import time
import uuid

import requests

API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}


def generate(model, prompt, **options):
    # One Idempotency-Key per job: resend with the same key after a timeout and you get the same job back.
    key = str(uuid.uuid4())
    job = requests.post(f"{API}/generations", headers={**HEADERS, "Idempotency-Key": key}, json={
        "model": model,
        "input": {"prompt": prompt, **options},
        "max_cost_usd": 0.1,  # your cap: the most this job may cost
    }).json()
    while job["status"] in ("queued", "running"):
        time.sleep(3)
        job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()
    return job


prompt = "Studio photo of a ceramic coffee mug with a hand-painted blue wave, on a linen cloth, morning window light."
# Draft with Flare, then render the keeper with Sunburst: same request, another model id.
for model in ("gpt-image-2.6-flare", "gpt-image-2.6-sunburst"):
    job = generate(model, prompt, resolution="2K", aspect_ratio="4:3")
    print(model, job["status"], job.get("output"), job.get("cost_usd"))

{
  "id": "gen_01JC7P3K8D",
  "model": "gpt-image-2.6-flare",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC7P3K8D/0.png"
    ]
  },
  "cost_usd": 0.02,
  "attempts": 1,
  "error": null,
  "created_at": "2026-11-05T14:02:11Z",
  "completed_at": "2026-11-05T14:02:40Z"
}

{
  "model": "gpt-image-2.6-sunburst",
  "input": {
    "prompt": "Put the perfume bottle from the first image on the marble shelf from the second image, beside a sprig of eucalyptus. Keep the bottle's label and logo exactly as they are. Soft side light.",
    "image_urls": [
      "https://example.com/bottle.png",
      "https://example.com/shelf.jpg"
    ],
    "resolution": "2K",
    "aspect_ratio": "4:3"
  },
  "max_cost_usd": 0.1
}

claude mcp add --transport http revana https://revana.si/api/mcp