Image

Ideogram v3 Balanced API

The default, everyday rendering tier of Ideogram 3.0 (Mar 2025), balancing speed and quality and built around the model's industry-leading text rendering.

Get API key Read the docs

~21s
Avg. generation: 8 credits
From

Ideogram v3 Balanced bold event poster reading 'NEON NIGHTS' with the subtitle 'Live This Saturday' in a vibrant retro design

Playground

Try Ideogram v3 Balanced right here.

model: ideogram-v3-balanced

Prompt

Aspect ratio

Style

Magic prompt

Media inputs

Reference image

Advanced settings

Negative prompt Rendering speed Seed

Estimated cost 8 credits · $0.08 Generate in Studio

Output

Your output lands here. Hit generate to run this request in Studio.

Pricing

Simple per-generation pricing.

8 credits per generation ≈ $0.08

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

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

Image input Supported

Avg. time ~21s

Quickstart

How to call the Ideogram v3 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-v3-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-v3-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-v3-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-v3-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 v3 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-v3-balanced" · "ideogram-v3-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 v3 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 12 cr Ideogram v4 Quality

Production images with typography that actually reads.

Explore Ideogram v4 Quality All image models

Ideogram v3 Balanced questions

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

What is Ideogram v3 Balanced?

The default rendering tier of Ideogram 3.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 4 credits ($0.04) for drafts, Balanced is the standard at 8 credits ($0.08), and Quality is the slowest and highest-fidelity at 11 credits ($0.11).

What is Ideogram best known for?

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

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.