Ideogram Character

IdeogramImages

Ideogram Character: one reference portrait in, the same character in new scenes, poses and styles.

Our price
$0.13
per image
Official
$0.15
15% vs official

First request

from openai import OpenAI

client = OpenAI(
    base_url="https://api.altrouter.ai/v1",
    api_key="ar-...",
)

img = client.images.generate(
    model="ideogram-character",
    prompt="a red fox in the snow",
)
print(img.data[0].url)

The interface is OpenAI-compatible: in existing code only the base_url, the key and the model id change — nothing else.

Ideogram Character against its price neighbours

Ideogram Character and its closest neighbours by price: prices and parameters from the AltRouter AI catalog
ModelPriceUnitDiscount
Midjourney V8Midjourney$0.074imageOpen
FLUX.1 Kontext MaxBlack Forest$0.082imageOpen
FLUX.2 FlexBlack Forest$0.089imageOpen
Nano Banana ProGoogle$0.12image−10%Open
Ideogram Characterthis pageIdeogram$0.13image−15%

Prices and parameters come from the same catalog as the price above; this is not a benchmark, it is comparable billing terms.

Limits

Pricing is flat — $0.13 per image, regardless of prompt length. Allowed image_size values: square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

There is no subscription: every successful request is billed at the price above, and a failed one is not billed at all. That price is already 15% below the vendor's official one — the official price is shown struck through next to it so it can be checked. No Ideogram account of your own is needed, and no VPN: requests go to api.altrouter.ai and we make the upstream call.

Rate limiting is shared across models and counted per key: 600 requests per minute by default, and a 429 with retry-after: 60 above it. An individual key can get its own limit and a spending cap per day, week, month or lifetime in the dashboard.

Full limits and credits

When to pick Ideogram Character, and when a neighbour

The cheaper neighbour is Nano Banana Pro: $0.12 per image against $0.13 for Ideogram Character. On the same volume the bill comes out 1.1× smaller. It is the sensible pick where the task is repetitive and high-volume — labelling, classification, short templated answers — the kind of work where quality is bounded by the prompt rather than the model.

Guessing is more expensive than checking: the table above is prices and parameters, not a benchmark, and it cannot tell you which model does better on your own prompt. Switching costs one line — the model id in the request changes, the base_url and the key stay — so running both on your own data takes minutes.

API

OpenAI-compatible image generation endpoint. The result is re-hosted on our CDN and returned as a URL.

POST/v1/images/generations
Body parameters
modelstringrequired"ideogram-character"
The model id.
promptstringrequired
The text description of the image.
imagestringURL or base64
Reference images for editing.
image_sizeenumsquare_hd · square · portrait_4_3 · portrait_16_9 · landscape_4_3 · landscape_16_9default square_hd
Image size / orientation preset.
styleenumAUTO · REALISTIC · FICTIONdefault AUTO
expand_promptbooleandefault true
negative_promptstring
What to exclude from the image.
seednumber0–2147483647
Seed for reproducibility.
Response
createdinteger
Unix creation time (seconds).
dataarray
Images. Each: url (our CDN), b64_json, revised_prompt.
Example
cURLPythonJavaScriptJSON
curl https://api.altrouter.ai/v1/images/generations \
  -H "Authorization: Bearer ar-..." \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ideogram-character",
  "prompt": "a red fox in the snow",
  "image_size": "square_hd",
  "style": "AUTO"
}'
Errors
400Invalid request.
401Missing or invalid API key.
402Insufficient credits, or the key’s spending cap is exhausted.
404Model not found.
429Rate limit exceeded.

More from Ideogram