Ideogram V3 Balanced

Generate high-quality images with exceptional typography using Ideogram V3 Balanced. This versatile model offers the optimal balance between speed, quality, and cost — perfect for everyday design work, marketing materials, and professional content creation.

Why It Looks Great

Balanced performance: Optimal trade-off between speed, quality, and price.
Superior typography: Industry-leading text rendering for posters, logos, and designs.
Multiple modes: Text-to-image generation, image editing, and masked inpainting.
Style presets: Choose from Auto, General, Realistic, or Design styles.
Reference images: Use up to 3 reference images to guide generation.
Mask support: Precise regional editing with custom masks.
Flexible aspect ratios: Five format options for any use case.
Safety Checker: Optional content filtering for appropriate output.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
image	No	Source image for editing (upload or public URL).
mask_image	No	Mask to specify edit regions — white areas will be regenerated.
style	No	Output style: Auto, General, Realistic, or Design. Default: Auto.
aspect_ratio	No	Output format: 1:1, 16:9, 9:16, 4:3, or 3:4. Default: 1:1.
reference_images	No	Up to 3 reference images to guide style and composition.
enable_base64_output	No	API only: Returns base64 string instead of URL.
Enable Safety Checker	No	Toggle content safety filtering.

How to Use

Text-to-Image Generation

Write your prompt — describe the image including any text you want rendered.
Choose style — select Auto, General, Realistic, or Design.
Set aspect ratio — pick the format that fits your use case.
Add reference images (optional) — click "+ Add Item" to include style references.
Run — click the button to generate.
Download — preview and save your image.

Image Editing

Upload source image — the image you want to edit.
Upload mask (optional) — white areas indicate regions to regenerate.
Write your prompt — describe the desired changes or new elements.
Run — click the button to apply edits.

Pricing

Flat rate per image generation.

Output	Cost
Per image	$0.06

Style Guide

Style	Description	Best For
Auto	Automatically selects the best style	General use, when unsure
General	Balanced, versatile output	Wide range of subjects
Realistic	Photorealistic, natural appearance	Photos, portraits, products
Design	Graphic design aesthetic	Posters, logos, marketing materials

Best Use Cases

Everyday Design Work — Create quality designs without premium pricing.
Marketing Content — Produce professional graphics for campaigns and social media.
Logo & Branding — Generate polished brand concepts and materials.
Typography & Posters — Create designs with clean, readable text.
Production Workflows — Balance quality and volume for regular content needs.

Example Prompts

"modern minimalist poster saying 'DESIGN WEEK 2025', clean sans-serif typography, gradient background"
"coffee shop menu board with text 'Today's Special: Caramel Latte', chalkboard style, warm tones"
"YouTube thumbnail with bold text 'TOP 10 TIPS', energetic colors, eye-catching design"
"event invitation for 'Summer Garden Party', floral illustrations, elegant script font"
"app splash screen with logo 'FOCUS', minimal design, calming blue gradient"

Model Comparison

Model	Cost	Speed	Quality	Best For
Ideogram V3 Turbo	$0.03	Fastest	Good	Rapid iteration, testing
Ideogram V3 Balanced	$0.06	Medium	Better	Everyday production work
Ideogram V3 Quality	$0.09	Standard	Best	Final deliverables, print

Pro Tips for Best Results

Balanced is ideal for most production work — great quality at reasonable cost.
For typography, put the exact text in quotes within your prompt.
Use the Design style for graphic design work with text elements.
Use Turbo for testing concepts, Balanced for production, Quality for finals.
Reference images help maintain consistency across multiple generations.
Describe typography style: "modern", "clean", "bold", "elegant".

Notes

Ideogram is renowned for best-in-class text rendering in AI-generated images.
Balanced mode is the recommended choice for most everyday use cases.
If using URLs for images, ensure they are publicly accessible.
The enable_base64_output option is only available through the API.
Reference images (up to 3) help guide style without directly copying content.

Ideogram v3 Balanced API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v3-balanced with your input as JSON. The endpoint returns a prediction id; poll the prediction endpoint until status flips to completed, then read the output URL from data.outputs[0]. Examples for Ideogram v3 Balanced below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v3-balanced" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "style": "Auto",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
}'

# Response includes a prediction id. Poll for the result:
curl -X GET "https://api.wavespeed.ai/api/v3/predictions/{request_id}/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"

# When status is "completed", read the output from data.outputs[0].

Node.js example

// npm install wavespeed
const WaveSpeed = require('wavespeed');

const client = new WaveSpeed(); // reads WAVESPEED_API_KEY from env

const result = await client.run("ideogram-ai/ideogram-v3-balanced", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "image": "https://example.com/your-input.jpg",
        "style": "Auto",
        "aspect_ratio": "1:1",
        "enable_base64_output": false
});

console.log(result.outputs[0]); // → URL of the generated output

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "ideogram-ai/ideogram-v3-balanced",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "image": "https://example.com/your-input.jpg",
    "style": "Auto",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
}
)

print(output["outputs"][0])  # → URL of the generated output

Ideogram v3 Balanced API — Frequently asked questions

What is the Ideogram v3 Balanced API?

Ideogram v3 Balanced is a Ideogram model for image generation, exposed as a REST API on WaveSpeedAI. Ideogram V3 Balanced delivers the highest-quality image generation with stunning realism, creative design, and consistent styles. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Ideogram v3 Balanced API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID; poll the prediction endpoint until status flips to "completed", then read the output URL from the result. The playground generates a ready-to-paste code sample in Python, JavaScript, or cURL for whatever inputs you've set. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-v3-balanced.

How much does Ideogram v3 Balanced cost per run?

Ideogram v3 Balanced starts at $0.060 per run. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does Ideogram v3 Balanced accept?

Key inputs: `prompt`, `image`, `aspect_ratio`, `reference_images`, `enable_base64_output`, `mask_image`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/ideogram-ai/ideogram-ai-ideogram-v3-balanced.

How long does Ideogram v3 Balanced take to generate?

Average end-to-end generation time on WaveSpeedAI is around 10 seconds per request — measured across recent runs. Queue time scales with global demand; live status is visible in the prediction record.

Can I use Ideogram v3 Balanced outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Ideogram). The license summary appears on the model card above; see WaveSpeedAI's Terms of Service for platform-level conditions.

ExamplesView all

Related Models

README