Recraft API: Recraft V4.1, V4.1 Utility and Crisp Upscale per image, with 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": "recraft-v4.1",
    "input": {
      "prompt": "Flat illustration of a fox reading a book under a desk lamp, warm orange and teal palette, clean shapes, lots of empty space.",
      "resolution": "1K",
      "aspect_ratio": "4:5"
    },
    "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_01JC4N7X3P \
  -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": "recraft-v4.1",
    "input": {
        "prompt": "Flat illustration of a fox reading a book under a desk lamp, warm orange and teal palette, clean shapes, lots of empty space.",
        "resolution": "1K",
        "aspect_ratio": "4:5",
    },
    "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_01JC4N7X3P",
  "model": "recraft-v4.1",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC4N7X3P/0.png"
    ]
  },
  "cost_usd": 0.05,
  "attempts": 1,
  "error": null,
  "created_at": "2026-11-13T10:14:02Z",
  "completed_at": "2026-11-13T10:14:31Z"
}

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