Apiframe Logo Apiframe
Ideogram v4 Quality icon
Image by Ideogram

Ideogram v4 Quality API

The highest-fidelity tier of Ideogram 4.0, built for final, production-ready assets where text accuracy and visual polish matter most.

Integrate Ideogram v4 Quality with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.

Get API Key Use in Apiframe Studio View Ideogram v4 Quality API Docs
model: "ideogram-v4-quality"

What's special about Ideogram v4 Quality

The top tier of the family

Quality delivers the most fidelity of the three Ideogram 4.0 modes, at around $0.10 per image, trading speed for the cleanest, most refined output.

Best-in-class text rendering

It carries Ideogram's signature typography strength furthest, handling complex, multi-line, and multilingual text accurately enough for professional design.

Polished realism and composition

Version 4 produces the family’s most detailed photorealism, spatial layout, and lighting, suited to client-facing and brand-critical work.

Deep style control

You can guide it with up to three reference images, reuse looks with style presets for consistent branding, and pick across Realistic, General, Design, and Auto style types.

Higher resolutions

Version 4 adds support for higher output resolutions, ideal for large-format and print-ready assets.

Part of a tiered workflow

It shares the v4 family’s Magic Prompt rewriting, so you can prototype on Turbo or Balanced and finish on Quality without changing your setup.

Made with Ideogram v4 Quality

A few outputs generated through the Ideogram v4 Quality API on Apiframe.

Sample coming soon

A cinematic portrait of an astronaut in a neon-lit alley, 85mm, shallow depth of field

Sample coming soon

Cozy isometric coffee shop, warm morning light, highly detailed 3D render

Sample coming soon

A majestic snow leopard on a misty mountain ridge at golden hour

Overview

Endpoint
POST /v2/images/generate
Model ID
ideogram-v4-quality
Params key
ideogramParams
Modality
Image
Provider
Ideogram
Avg. completion
~28s

Capabilities

Aspect ratios1:1, 3:4, 4:3, 9:16, 16:9
Image inputSupported
Avg. time~28s

Quick start

Send a single POST /v2/images/generate request with your API key to generate with Ideogram v4 Quality. The call returns a jobId you can poll or receive via webhook. 

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-v4-quality",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    }'
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-v4-quality",
        "ideogramParams": {
            "style_type": "AUTO",
            "magic_prompt_option": "Auto",
            "image": "https://example.com/input.jpg",
            "negative_prompt": "What you do NOT want to see…"
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }
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-v4-quality",
    "ideogramParams": {
      "style_type": "AUTO",
      "magic_prompt_option": "Auto",
      "image": "https://example.com/input.jpg",
      "negative_prompt": "What you do NOT want to see…"
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

Response & job lifecycle

Generation is asynchronous. A successful submission returns 202 Accepted with a jobId. Poll GET /v2/jobs/{id} (or supply a webhook_url) until the status is COMPLETED; the result field then holds the output URL(s).

1. Submission response (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. Poll for the result

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"
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"])
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);

Input schema

Request parameters accepted by the Ideogram v4 Quality endpoint. Model-specific options are nested under the params object shown below.

Parameter Type Required Default Allowed / range Description
prompt string required — — Text description of what to generate.
model string required "ideogram-v4-quality" "ideogram-v4-quality" The model identifier for this endpoint.
ideogramParams.style_type string optional "AUTO" "AUTO", "GENERAL", "REALISTIC", "DESIGN" Style
ideogramParams.magic_prompt_option string optional "Auto" "Auto", "On", "Off" Let Ideogram rewrite your prompt for better results.
ideogramParams.image string (URL) optional — — Reference image (URL)
ideogramParams.negative_prompt string optional — — Negative prompt
ideogramParams.rendering_speed string optional "default" "default", "turbo", "quality" Rendering speed
ideogramParams.seed number optional — step 1 Reuse a number to reproduce the same result.

Related models

Ideogram v3 Balanced iconIdeogram v3 Balanced

Strong typography and posters; balanced speed/quality.

Ideogram v3 Balanced API →
Ideogram v3 Quality iconIdeogram v3 Quality

Highest-quality Ideogram tier.

Ideogram v3 Quality API →
Ideogram v3 Turbo iconIdeogram v3 Turbo

Fast Ideogram for quick iterations.

Ideogram v3 Turbo API →
Ideogram v4 Balanced iconIdeogram v4 Balanced

Fourth-gen Ideogram; balanced speed and quality with sharper text.

Ideogram v4 Balanced API →
Ideogram v4 Turbo iconIdeogram v4 Turbo

Fast, affordable Ideogram v4 for quick iterations.

Ideogram v4 Turbo API →
Ideogram Character iconIdeogram Character

Generate consistent characters from a reference image.

Ideogram Character API →

Frequently Asked Questions

Common questions about the Ideogram v4 Quality API.

What is Ideogram v4 Quality?

The highest-fidelity tier of Ideogram 4.0, built for final, production-grade images.

How is it different from Turbo and Balanced?

Quality is the slowest and most detailed at about $0.10 per image, while Balanced is the everyday standard at about $0.06 and Turbo is the fast draft tier at about $0.03.

How does v4 compare to v3?

Ideogram 4.0 improves on 3.0’s image-prompt alignment, photorealism, and text rendering, and adds support for higher resolutions.

What is it best for?

Brand-critical design, marketing assets, packaging, and any work where text accuracy and polish are essential.

How do you get accurate text in an image?

Wrap the words you want in quotation marks within your prompt, and keep the text short for the most reliable results.

Still have questions?

Contact Support Join Discord

Start building with the Ideogram v4 Quality API

Get your API key and integrate Ideogram v4 Quality in minutes — Pay-as-you-go.

Free credits to start
One API for every model
Webhooks, SDKs & idempotency
No provider account required
Get Started Free Read Documentation

Questions? Join our Discord or contact sales.