Ideogram API pricing: Ideogram V3, V4 and Character 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": "ideogram-v4",
    "input": {
      "prompt": "A retro travel poster with the title \"LISBON\" in bold cream letters at the top, a yellow tram climbing a steep street at sunset, screen-print texture.",
      "quality": "balanced",
      "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_01JC4P5K9W \
  -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": "ideogram-v4",
    "input": {
        "prompt": 'A retro travel poster with the title "LISBON" in bold cream letters at the top, a yellow tram climbing a steep street at sunset, screen-print texture.',
        "quality": "balanced",
        "aspect_ratio": "2:3",
    },
    "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_01JC4P5K9W",
  "model": "ideogram-v4",
  "status": "succeeded",
  "output": {
    "urls": [
      "https://cdn.revana.si/g/gen_01JC4P5K9W/0.png"
    ]
  },
  "cost_usd": 0.08,
  "attempts": 1,
  "error": null,
  "created_at": "2026-11-13T10:14:02Z",
  "completed_at": "2026-11-13T10:14:31Z"
}

{
  "model": "ideogram-v3",
  "input": {
    "prompt": "The same shop front at night with a neon sign that reads \"OPEN LATE\", rain on the street, cinematic light.",
    "image_url": "https://example.com/shop-front.jpg",
    "quality": "turbo",
    "aspect_ratio": "16:9"
  },
  "max_cost_usd": 0.05
}

{
  "model": "ideogram-character",
  "input": {
    "prompt": "The same woman as a barista in a sunlit cafe, smiling, holding a latte, 35mm photo.",
    "image_url": "https://example.com/face.jpg",
    "quality": "turbo",
    "aspect_ratio": "3:4"
  },
  "max_cost_usd": 0.1
}