Ideogram V4 Text to Image API

Ideogram V4

Ideogram V4 generates high-quality images from natural-language prompts. It is designed for posters, murals, branding concepts, social graphics, product visuals, and other prompt-driven image generation workflows where clean composition and strong text-aware design matter.

Why Choose This?

High-quality text-to-image generation
Turn natural-language prompts into polished visual outputs.
Strong design-oriented results
Works well for posters, public art concepts, typography-led visuals, and graphic compositions.
Simple workflow
Just provide a prompt, choose a size, and generate.
Flexible aspect ratios
Supports square, portrait, and landscape layouts for different publishing needs.
Production-ready API
Suitable for marketing visuals, branded graphics, creative ideation, and content production workflows.

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the image you want to generate.
size	No	Output image aspect ratio, such as `1:1`, `3:4`, `4:3`, `16:9`, `9:16`.
output_format	No	Output image format, such as `jpeg`.

How to Use

Write your prompt — describe the subject, style, composition, lighting, and mood you want.
Choose size — select the aspect ratio that best fits your layout or platform.
Choose output format — select the file 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

Just $0.07 per image!

Best Use Cases

Posters and mural concepts — Create bold, graphic, text-forward visuals.
Brand and campaign graphics — Generate polished marketing images from prompts.
Social media visuals — Produce square, portrait, or vertical content for modern platforms.
Typography-led design — Explore layouts where text and composition both matter.
Creative ideation — Quickly test multiple visual directions for campaigns or public art concepts.

Pro Tips

Be specific in your prompt about subject, material, composition, and lighting.
If text inside the image matters, describe the exact wording and visual treatment clearly.
Use 1:1 for square social graphics and centered compositions.
Use 3:4 or 4:3 for poster-like layouts.
Use 16:9 or 9:16 for widescreen or vertical content.
Choose jpeg for lightweight delivery unless your workflow requires another format.

Notes

prompt is required.
The model returns a single generated image per request.
Pricing depends on the selected size.
Better prompts usually improve both readability and composition quality.

Related Models

Ideogram Remove Background — Remove the background from an input image and return a transparent cutout.
Other Ideogram image generation workflows — Useful when you need different quality, speed, or editing tradeoffs.

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",
    "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",
        "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",
    "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 flexible output sizes. 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.070 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`. 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.

ExamplesView all

Related Models

README

Ideogram V4

Why Choose This?

Parameters

How to Use

Example Prompt

Pricing

Best Use Cases

Pro Tips

Notes

Related Models

Ideogram v4 API — Quick start

Ideogram v4 API — Frequently asked questions