models/Ideogram/Ideogram V3 Character
Ideogram

Ideogram V3 Character

image
Compare

Generate consistent character appearances across multiple images. Maintain facial features, proportions, and distinctive traits for cohesive storytelling and branding

MODALITIES
image
PER IMAGE
$0.050

Ideogram V3 Character (ideogram/ideogram-character) is a image model from Ideogram. Pricing via AIgateway: $0.050 per image. Call it via https://api.aigateway.sh/v1/images/generations — set model="ideogram/ideogram-character".

model · ideogram/ideogram-character

Use this model

model: ideogram/ideogram-character
curl https://api.aigateway.sh/v1/images/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ideogram/ideogram-character","prompt":"a serene cyberpunk city at dusk"}'

Capabilities

Pricing

Per image$0.050
You pay pass-through pricing.
See API example →CompareAPI referenceSee usage ranking →

Collections

More image models →More from Ideogram →Frontier models →Free-tier models →
API schema

Call Ideogram V3 Character from any OpenAI SDK

POST https://api.aigateway.sh/v1/images/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json
{
  "model": "ideogram/ideogram-character",
  "prompt": "A cyberpunk cat at sunset, cinematic lighting",
  "n": 1,
  "size": "1024x1024",
  "response_format": "url"   // or "b64_json"
}

Response

json
{
  "created": 1776947082,
  "data": [
    { "url": "https://media.aigateway.sh/img/abc123.png" }
    // or { "b64_json": "iVBORw0KGgoAAAANSUhEU..." }
  ]
}

Quickstart

from openai import OpenAI
client = OpenAI(base_url="https://api.aigateway.sh/v1", api_key="sk-aig-...")

r = client.images.generate(
    model="ideogram/ideogram-character",
    prompt="a cyberpunk cat at sunset",
    size="1024x1024",
)
print(r.data[0].url)

Errors

401authentication_errorInvalid or missing API key
402insufficient_creditsWallet empty (PAYG only)
404not_foundUnknown model or endpoint
429rate_limit_errorOver per-minute limit — see Retry-After header
500server_errorUpstream provider failed (retryable)
503service_unavailableUpstream saturated (retryable)
Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Ideogram V3 Character?
Generate consistent character appearances across multiple images. Maintain facial features, proportions, and distinctive traits for cohesive storytelling and branding It is a image model from Ideogram, accessible via AIgateway's OpenAI-compatible API at slug ideogram/ideogram-character.
How much does Ideogram V3 Character cost via AIgateway?
$0.0500 per image, billed pass-through.
How do I call Ideogram V3 Character from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "ideogram/ideogram-character". The request and response shapes match OpenAI exactly.
Does Ideogram V3 Character support streaming, tool calling, vision, and JSON mode?
Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.
Can I bring my own Ideogram API key (BYOK)?
Yes. Attach a Ideogram key in your AIgateway dashboard and this model flips to pass-through — you pay Ideogram directly and AIgateway adds no platform fee on those calls.