AI image generator API: pick a model, send a prompt, pay per image

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": "nano-banana-pro",
    "input": {
      "prompt": "A minimalist poster for a jazz night, the words BLUE NOTE FRIDAY in bold serif, deep blue and cream.",
      "resolution": "1K",
      "aspect_ratio": "3:4"
    },
    "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_01JC4M2R8D \
  -H "Authorization: Bearer $REVANA_API_KEY"

{
  "model": "gpt-image-2",
  "input": {
    "prompt": "Put this mug on a marble kitchen counter by a window. Keep the logo exactly as it is.",
    "image_urls": ["https://example.com/mug.png"],
    "resolution": "1K"
  },
  "max_cost_usd": 0.1
}

import os
import time
import uuid

import requests

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

# One Idempotency-Key per job, made once: resend with the same key after a timeout,
# a 429 or a 5xx and you get the same job back, never a second charge.
key = str(uuid.uuid4())
resp = requests.post(f"{API}/generations", headers={**HEADERS, "Idempotency-Key": key}, json={
    "model": "seedream-5.5",
    "input": {
        "prompt": "A running shoe on pale concrete, hard noon shadows, catalog photo.",
        "resolution": "2K",
        "aspect_ratio": "4:3",
        "num_images": 2,
    },
    "max_cost_usd": 0.2,  # your cap for the whole request
})
resp.raise_for_status()
gen_id = resp.json()["id"]

job = requests.get(f"{API}/generations/{gen_id}", headers=HEADERS).json()
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{gen_id}", headers=HEADERS).json()

if job["status"] == "succeeded":
    for i, url in enumerate(job["output"]["urls"]):
        ext = os.path.splitext(url.split("?")[0])[1] or ".png"
        with open(f"shoe-{i}{ext}", "wb") as f:
            f.write(requests.get(url).content)
    print("saved", len(job["output"]["urls"]), "pictures, cost", job["cost_usd"])
else:
    print("failed (free):", job["error"])