The everyday workhorse tier
Balanced sits between the Turbo and Quality modes, offering the best speed-to-quality ratio at 11 credits ($0.11) per image, with results typically arriving in under 30 seconds.
Image by Ideogram
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.
Integrate Ideogram v3 Balanced with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.
model: "ideogram-v3-balanced" 
What's special about Ideogram v3 Balanced
Industry-leading text rendering
Ideogram's signature strength is accurate, legible typography inside images, including multi-line and multilingual text, which makes it a go-to for design work.
Strong prompt alignment and realism
Version 3 improved image-prompt alignment, photorealism, and spatial composition, with precise control over lighting and color.
Deep style control
You can upload up to three reference images, reuse looks with Style Codes for consistent branding, and draw on a library of billions of style presets across Realistic, General, Design, and Auto style types.
A full editing toolset
Beyond text-to-image, it supports Magic Fill inpainting, Extend outpainting, reframing, and remixing, plus image-to-image workflows.
Easy to scale up or down
It shares Ideogram 3.0's Magic Prompt rewriting and batch generation, and you can switch to Turbo for drafts or Quality for final assets without changing your workflow.
Made with Ideogram v3 Balanced
A few outputs generated through the Ideogram v3 Balanced API on Apiframe.
A bold event poster with the title 'NEON NIGHTS' and the subtitle 'Live This Saturday', vibrant retro design.
A coffee packaging label reading 'MORNING RITUAL' with 'Medium Roast' beneath, clean minimal layout.
A YouTube thumbnail with the text 'TOP 5 TIPS' in bold yellow, a surprised face, bright background.
A vintage travel poster reading 'EXPLORE ICELAND' with a glacier and aurora, art-deco type.
A photorealistic product shot of a skincare bottle labeled 'GLOW' on a marble surface, soft light.
A greeting card reading 'Happy Birthday' in elegant hand-lettered script, floral border.
Overview
- Endpoint
- POST /v2/images/generate
- Model ID
- ideogram-v3-balanced
- Params key
- ideogramParams
- Modality
- Image
- Provider
- Ideogram
- Avg. completion
- ~25s
Capabilities
Aspect ratios1:1, 3:4, 4:3, 9:16, 16:9
Image inputSupported
Avg. time~25s
Quick start
Send a single POST /v2/images/generate request with your API key to
generate with Ideogram v3 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-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…"
}
}'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" }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);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 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-v3-balanced" | "ideogram-v3-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 v3 Balanced API.
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 6 credits ($0.06) for drafts, Balanced is the standard at 11 credits ($0.11), and Quality is the slowest and highest-fidelity at 16 credits ($0.16).
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.
Still have questions?
Start building with the Ideogram v3 Balanced API
Get your API key and integrate Ideogram v3 Balanced in minutes — Pay-as-you-go.
Free credits to start
One API for every model
Webhooks, SDKs & idempotency
No provider account required
Questions? Join our Discord or contact sales.