Image

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.

Get API key Read the docs

~22s
Avg. generation: 11 credits
From

Ideogram v3 Balanced bold event poster with the title 'NEON NIGHTS' and the subtitle 'Live This Saturday' in a vibrant retro design — A bold event poster with the title 'NEON NIGHTS' and the subtitle 'Live This Saturday', vibrant retro design.

Playground

Try Ideogram v4 Balanced right here.

model: ideogram-v4-balanced

Prompt

Aspect ratio

Style

Magic prompt

Media inputs

Reference image

Advanced settings

Negative prompt Rendering speed Seed

Estimated cost 11 credits · $0.11 Generate in Studio

Output Example · Ideogram v3 Balanced

Pricing

Simple per-generation pricing.

11 credits per generation ≈ $0.11

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-v4-balanced

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

Image input Supported

Avg. time ~22s

Quickstart

How to call the Ideogram v4 Balanced 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-v4-balanced 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-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);

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" }

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…"
        }
    }'

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 v4 Balanced 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-v4-balanced" · "ideogram-v4-balanced"
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.image	string (URL)	Reference image (URL)
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 v4 Balanced is one of 7 Ideogram image models on Apiframe. The full editorial page (showcase, comparison, and use cases) lives on the flagship.

Flagship from 18 cr Ideogram v4 Quality

Production images with typography that actually reads.

Explore Ideogram v4 Quality All image models

Ideogram v4 Balanced questions

What teams ask before shipping with Ideogram v4 Balanced. Everything else lives in the docs.

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 6 credits ($0.06) for drafts, Balanced is the standard at 11 credits ($0.11), and Quality is the slowest and highest-fidelity at 18 credits ($0.18).

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.