Image editing API: edit photos with a prompt, priced 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": "Put the bottle on a white marble counter in soft morning window light. Keep the bottle, its label and its cap exactly as they are.",
      "image_url": "https://example.com/bottle.jpg",
      "resolution": "1K"
    },
    "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_01JC4R3H6N \
  -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']}"}
# One Idempotency-Key per job, made once. Resend after a timeout, a 429 or a 5xx with the
# same KEY: 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": "nano-banana-pro",
    "input": {
        "prompt": "Put the bottle on a white marble counter in soft morning window light. Keep the bottle, its label and its cap exactly as they are.",
        "image_url": "https://example.com/bottle.jpg",
        "resolution": "1K",
    },
    "max_cost_usd": 0.1,  # your cap: the most this job may cost
})
resp.raise_for_status()
job = resp.json()

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

if job["status"] == "succeeded":
    print(job["output"]["urls"], job["cost_usd"])
else:
    # A failed job is free. To try again, make a new KEY: this one answers with the failure.
    print("Failed:", job["error"])

{
  "id": "gen_01JC4R3H6N",
  "model": "nano-banana-pro",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC4R3H6N/0.png"
    ]
  },
  "cost_usd": 0.04,
  "attempts": 1,
  "error": null,
  "created_at": "2026-11-13T10:14:02Z",
  "completed_at": "2026-11-13T10:14:31Z"
}

{
  "model": "gpt-image-2",
  "input": {
    "prompt": "Put the watch from the first picture on the left wrist of the person in the second picture. Keep the watch face, strap and logo exactly as they are. Natural daylight.",
    "image_urls": [
      "https://example.com/watch.jpg",
      "https://example.com/model.jpg"
    ],
    "resolution": "1K",
    "aspect_ratio": "3:4"
  },
  "max_cost_usd": 0.1
}

import os

import requests

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


def upload(path, content_type="image/jpeg"):
    """Upload a local picture and return a link to use as image_url (good for 14 days)."""
    with open(path, "rb") as f:
        data = f.read()
    resp = requests.post(f"{API}/uploads", headers=HEADERS, json={
        "content_type": content_type,
        "bytes": len(data),
        "filename": os.path.basename(path),
    })
    resp.raise_for_status()
    up = resp.json()
    # PUT the bytes within an hour, with exactly the headers it gives you
    requests.put(up["upload_url"], data=data, headers=up["upload_headers"]).raise_for_status()
    return up["url"]


image_url = upload("bottle.jpg")

{
  "model": "recraft-crisp-upscale",
  "input": {
    "image_url": "https://example.com/bottle-edited.png"
  },
  "max_cost_usd": 0.05
}