Ideogram V4 Text to Image API

Ideogram V4

Ideogram V4 generates high-quality images from natural-language prompts with flexible aspect ratios, configurable rendering speed, and multiple output formats. It is well suited for posters, public art concepts, typography-driven visuals, product ideas, social content, and other prompt-based image generation workflows.

Why Choose This?

Strong prompt-based image generation
Turn natural-language descriptions into polished visual outputs.
Flexible aspect ratio presets
Choose a size preset that fits square, portrait, or landscape compositions.
Speed-quality tradeoff control
Use rendering_speed to balance cost, speed, and output quality.
Multiple output formats
Export generated results in formats such as jpeg.
Great for text-forward visuals
Useful for murals, signage, poster-style graphics, and other design-led imagery.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
size	No	Output size preset, such as `1:1`, `3:4`, `4:3`, `16:9`, or `9:16`.
rendering_speed	No	Rendering mode that controls quality and cost. Supported values include `TURBO`, `BALANCED`, and `QUALITY`.
output_format	No	Output image format, such as `jpeg`.

How to Use

Write your prompt — describe the subject, style, lighting, composition, and mood you want.
Choose the size — select the aspect ratio that fits your final layout.
Choose rendering speed — use TURBO for lower cost, BALANCED for a middle option, or QUALITY for the highest cost and quality.
Choose output format — select the format that best fits your workflow.
Submit — run the model and download the generated image.

Example Prompt

A bold urban mural, "YOU ARE HERE" in oversized 3D block letters, glowing sunset gradient with turquoise accents, surrounded by blooming flowers, doves, and leafy branches flowing outward from the text, photorealistic exterior wall, mural paint texture, positive reflective message, energetic public art style

Pricing

Pricing depends on both rendering_speed and size.

1:1

Rendering Speed	Cost
TURBO	$0.04
BALANCED	$0.07
QUALITY	$0.11

3:4 or 4:3

Rendering Speed	Cost
TURBO	$0.03
BALANCED	$0.05
QUALITY	$0.08

16:9, 9:16, 3:2, 2:3, 9:21, or 21:9

Rendering Speed	Cost
TURBO	$0.02
BALANCED	$0.04
QUALITY	$0.06

Billing Rules

Pricing depends on both rendering_speed and size
1:1 is the highest-priced size tier
3:4 and 4:3 use the same price tier
16:9, 9:16, 3:2, 2:3, 9:21, and 21:9 use the same price tier
Prices are rounded up to the nearest $0.01
output_format does not affect pricing

Best Use Cases

Poster and mural concepts — Create bold, text-led visuals for public art and print concepts.
Brand graphics — Generate polished campaign or promotional imagery.
Typography-forward design — Explore layouts that center around words, slogans, or signage.
Social media visuals — Create stylized graphics for posts and short-form campaigns.
Creative ideation — Test multiple visual directions quickly with different rendering modes.

Pro Tips

Use TURBO when you want cheaper, faster experimentation.
Use QUALITY when the result is for final delivery or closer review.
Choose 1:1 for square composition-heavy outputs and social graphics.
Choose 3:4 or 4:3 for poster-like or editorial framing.
Choose 16:9 or 9:16 for widescreen or vertical content.
Be specific in your prompt about subject, materials, lighting, and layout when text readability matters.

Notes

prompt is required.
Pricing varies by both rendering mode and size.
BALANCED is the middle pricing tier between TURBO and QUALITY.
The values above are based on the current formula and may change if the provider updates pricing.

Related Models

Other Ideogram image generation workflows — Useful when you need different quality, speed, or style tradeoffs.
Prompt-based design generation models — Useful when you want alternate visual aesthetics or layout behavior.

Ideogram v4 API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4 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 v4 below.

HTTP example

# Submit the prediction
curl -X POST "https://api.wavespeed.ai/api/v3/ideogram-ai/ideogram-v4" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1:1",
    "rendering_speed": "BALANCED",
    "output_format": "jpeg"
}'

# 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-v4", {
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "size": "1:1",
        "rendering_speed": "BALANCED",
        "output_format": "jpeg"
});

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

Python example

# pip install wavespeed
import wavespeed

output = wavespeed.run(
    "ideogram-ai/ideogram-v4",
    {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "size": "1:1",
    "rendering_speed": "BALANCED",
    "output_format": "jpeg"
}
)

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

Ideogram v4 API — Frequently asked questions

What is the Ideogram v4 API?

Ideogram v4 is a Ideogram model for image generation, exposed as a REST API on WaveSpeedAI. Ideogram V4 Text to Image is a fast AI image generation model that creates high-quality images, posters, and logos from text prompts with crisp visuals, accurate text rendering, strong detail, and controllable rendering speed. Ready-to-use REST inference API for logo design, poster creation, marketing visuals, brand assets, social media content, typography-rich images, and professional text-to-image workflows with simple integration, no coldstarts, and affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the Ideogram v4 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-v4.

How much does Ideogram v4 cost per run?

Ideogram v4 starts at $0.030 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 v4 accept?

Key inputs: `prompt`, `size`, `output_format`, `rendering_speed`. 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-v4.

How do I get started with the Ideogram v4 API?

Sign up for a free WaveSpeedAI account to claim starter credits, copy your API key from /accesskey, then call the endpoint shown in the API tab of the playground. The playground also auto-generates a code sample in Python, JavaScript, or cURL for the parameters you've set.

Can I use Ideogram v4 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.

ExemplesTout voir

Modèles associés

README