Image

Ideogram Character API

Ideogram's character-consistency model (Jul 2025) that keeps the same person or character recognizable across scenes, poses, and styles, all from a single reference image.

Get API key Read the docs

~60s
Avg. generation: 12 credits
From

Ideogram v4 Quality photoreal night street with a magenta neon sign reading MIDNIGHT ARCADE on a rain-wet brick storefront — Photoreal night photograph of a downtown storefront, a neon sign reading "MIDNIGHT ARCADE" in magenta, rain-wet pavement reflections, cinematic 35mm.

Playground

Try Ideogram Character right here.

model: ideogram-character

Prompt

Aspect ratio

Style

Magic prompt

Media inputs

Character reference

Advanced settings

Negative prompt Rendering speed Seed

Estimated cost 12–25 credits · $0.12–$0.25 Generate in Studio

Output Example · Ideogram v4 Quality

Pricing

Simple per-generation pricing.

12–25 credits per generation ≈ $0.12–$0.25

The rate depends on the resolution and options you pick.

You only pay for successful generations. Failed jobs are refunded automatically.
One credit balance across every model on Apiframe, no per-model plans.
Start with free credits. No subscription required.
Volume discounts on larger plans.

See plans and credit packs

Specs

At a glance.

Provider Ideogram

Model ID ideogram-character

Aspect ratios 1:1, 3:4, 4:3, 9:16, 16:9

Image input Supported

Avg. time ~60s

Quickstart

How to call the Ideogram Character API.

Send one POST /v2/images/generate request with your API key. The call returns a jobId you can poll, or pass a webhook_url and the result is pushed to you the moment it's ready.

Swap ideogram-character for any other model and nothing else changes.

Get API key Read the docs

generate.js

const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
    "model": "ideogram-character",
    "ideogramParams": {
      "character_reference_image": "https://example.com/input.jpg",
      "style_type": "AUTO",
      "magic_prompt_option": "Auto",
      "negative_prompt": "What you do NOT want to see…"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/generate",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-character",
        "ideogramParams": {
            "character_reference_image": "https://example.com/input.jpg",
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "negative_prompt": "What you do NOT want to see…"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }

curl -X POST https://api.apiframe.ai/v2/images/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "a sleek silver sports car on a coastal highway at sunset, hyper-realistic",
        "model": "ideogram-character",
        "ideogramParams": {
            "character_reference_image": "https://example.com/input.jpg",
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "negative_prompt": "What you do NOT want to see…"
        }
    }'

let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"

Input schema

Every field Ideogram Character accepts, with types and defaults. The full reference lives in the docs.

Field	Type	Description
prompt required	string	Text description of what to generate.
model required	string	The model identifier for this endpoint. Default:"ideogram-character" · "ideogram-character"
ideogramParams.character_reference_image	string (URL)	Required — the character to keep consistent across generations.
ideogramParams.style_type	string	Style Default:"AUTO" · "AUTO", "GENERAL", "REALISTIC", "DESIGN"
ideogramParams.magic_prompt_option	string	Let Ideogram rewrite your prompt for better results. Default:"Auto" · "Auto", "On", "Off"
ideogramParams.negative_prompt	string	Negative prompt
ideogramParams.rendering_speed	string	Rendering speed Default:"default" · "default", "turbo", "quality"
ideogramParams.seed	number	Reuse a number to reproduce the same result. step 1

The Ideogram flagship

Ideogram Character is one of 7 Ideogram image models on Apiframe. The full editorial page (showcase, comparison, and use cases) lives on the flagship.

Flagship from 12 cr Ideogram v4 Quality

Production images with typography that actually reads.

Explore Ideogram v4 Quality All image models