Ideogram v3 Quality API

The highest-fidelity rendering tier of Ideogram 3.0 (Mar 2025), built for final, production-ready assets where text accuracy and visual polish matter most.

Integrate Ideogram v3 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 v3 Quality API Docs

model: "ideogram-v3-quality"

Ideogram v3 Quality premium magazine cover reading 'ATLAS' with a bold masthead and a striking mountain photograph

What's special about Ideogram v3 Quality

The top tier of the family

Quality delivers the most fidelity of the three Ideogram 3.0 modes, at 16 credits ($0.16) 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

It 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 Codes for consistent branding, and draw on a large library of style presets across Realistic, General, Design, and Auto types.

A full editing toolset

Beyond text-to-image, it supports Magic Fill inpainting, Extend outpainting, reframing, and remixing, plus image-to-image workflows.

Part of a tiered workflow

It shares Ideogram 3.0's Magic Prompt rewriting and batch generation, so you can prototype on Turbo or Balanced and finish on Quality without changing your setup.

Made with Ideogram v3 Quality

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

Ideogram v3 Quality luxury perfume ad with the label 'NOIR' in elegant serif, a glossy black bottle, and dramatic lighting — A luxury perfume ad with the label 'NOIR' in elegant serif, glossy black bottle, dramatic lighting.

Ideogram v3 Quality detailed packaging design for artisan tea reading 'JASMINE GOLD' with intricate botanical art — A detailed packaging design for artisan tea reading 'JASMINE GOLD' with intricate botanical art.

Ideogram v3 Quality photorealistic billboard mockup reading 'DRIVE ELECTRIC' with a sleek car at golden hour — A photorealistic billboard mockup reading 'DRIVE ELECTRIC' with a sleek car at golden hour.

Ideogram v3 Quality multilingual event poster with the headline in English and Japanese in a refined modern layout — A multilingual event poster with the headline in English and Japanese, refined modern layout.

Ideogram v3 Quality finely detailed storefront sign reading 'THE CORNER BAKERY' in warm hand-painted lettering — A finely detailed storefront sign reading 'THE CORNER BAKERY' in warm hand-painted lettering.

Overview

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

Capabilities

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

Image inputSupported

Avg. time~30s

Quick start

Send a single POST /v2/images/generate request with your API key to generate with Ideogram v3 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-v3-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-v3-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-v3-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 v3 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-v3-quality"	"ideogram-v3-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.

Frequently Asked Questions

Common questions about the Ideogram v3 Quality API.

What is Ideogram v3 Quality?

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

How is it different from Turbo and Balanced?

Quality is the slowest and most detailed at 16 credits ($0.16) per image, while Balanced is the everyday standard at 11 credits ($0.11) and Turbo is the fast draft tier at 6 credits ($0.06).

What is it best for?

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

Can it edit images, not just generate them?

Yes. It supports Magic Fill inpainting, Extend outpainting, reframing, remixing, and image-to-image.

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.

Where can you access it?

Through Apiframe, as well as ideogram.ai, the iOS app, and the Ideogram v3 API.

Still have questions?

Contact Support Join Discord

Start building with the Ideogram v3 Quality API

Get your API key and integrate Ideogram v3 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.