Ideogram Ai Ideogram V3 Balanced

Playground

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.

Features

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.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v3-balanced" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "style": "Auto",
    "aspect_ratio": "1:1",
    "enable_base64_output": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
image	string	No		-	The image to generate an image from.
mask_image	string	No		-	The mask image tells the model where to generate new pixels (white) and where to preserve the original image (black). It acts as a stencil or guide for targeted image editing.
style	string	No	Auto	Auto, General, Realistic, Design	The style of the generated image.
aspect_ratio	string	No	1:1	1:1, 16:9, 9:16, 4:3, 3:4	The aspect ratio of the generated media.
reference_images	array	No	-	-	A list of images to use as style references.
enable_base64_output	boolean	No	false	-	If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Ideogram AI Ideogram V2A Turbo Ideogram AI Ideogram V3 Quality