Ideogram v4 Balanced API

The default, everyday tier of Ideogram 4.0, balancing speed and quality and built around the model's industry-leading text rendering and improved prompt alignment.

Integrate Ideogram v4 Balanced 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 Balanced API Docs

model: "ideogram-v4-balanced"

What's special about Ideogram v4 Balanced

The everyday workhorse tier

Balanced sits between the Turbo and Quality modes, offering the best speed-to-quality ratio at around $0.06 per image.

Industry-leading text rendering

Ideogram's signature strength is accurate, legible typography inside images, including multi-line and multilingual text, refined further in version 4.

Stronger prompt alignment and realism

Version 4 improves image-prompt alignment, photorealism, and spatial composition over 3.0, with precise control over lighting and color.

Deep style control

You can upload up to three reference images, reuse looks with style presets, and pick across Realistic, General, Design, and Auto style types.

Higher resolutions

Version 4 adds support for higher output resolutions for crisper, larger assets.

Easy to scale up or down

It shares the v4 family’s Magic Prompt rewriting, and you can switch to Turbo for drafts or Quality for final assets without changing your workflow.

Made with Ideogram v4 Balanced

A few outputs generated through the Ideogram v4 Balanced 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-balanced
Params key: ideogramParams
Modality: Image
Provider: Ideogram
Avg. completion: ~22s

Capabilities

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

Image inputSupported

Avg. time~22s

Quick start

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

What is Ideogram v4 Balanced?

The default tier of Ideogram 4.0, tuned to balance generation speed and image quality for everyday work.

How is it different from Turbo and Quality?

Turbo is the fastest and cheapest at about $0.03 for drafts, Balanced is the standard at about $0.06, and Quality is the slowest and highest-fidelity at about $0.10.

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 Ideogram best known for?

Accurate text rendering in images, widely regarded as among the best for typography and design.

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 Balanced API

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

Ideogram v4 Balanced API

What's special about Ideogram v4 Balanced

The everyday workhorse tier

Industry-leading text rendering

Stronger prompt alignment and realism

Deep style control

Higher resolutions

Easy to scale up or down

Made with Ideogram v4 Balanced

Overview

Capabilities

Quick start

Response & job lifecycle

1. Submission response (202)

2. Poll for the result

Input schema

Related models

Frequently Asked Questions

Start building with the Ideogram v4 Balanced API