Browse ModelsIdeogram AIIdeogram AI Ideogram V2

Ideogram Ai Ideogram V2

Ideogram Ai Ideogram V2

Playground

Try it on WavespeedAI!

Ideogram v2 is an image model with state-of-the-art inpainting, strong prompt comprehension, and accurate in-image text rendering. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Ideogram V2

Ideogram V2 is a powerful text-to-image generation model renowned for its exceptional ability to render text within images. Generate stunning visuals with accurate, readable text — perfect for posters, logos, typography, and designs that require precise text integration.


Why It Stands Out

  • Superior text rendering: Industry-leading accuracy for generating readable text within images.
  • Multi-mode support: Works as text-to-image, image-to-image, and inpainting generator.
  • Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
  • Style presets: Choose from various style options or let the model decide with Auto.
  • Flexible aspect ratios: Multiple aspect ratio presets for different use cases.
  • Inpainting support: Use mask images for precise, targeted image editing.

Parameters

ParameterRequiredDescription
promptYesText description of the image you want to generate.
imageNoSource image for image-to-image transformation.
mask_imageNoMask for inpainting (white = generate, black = preserve).
styleNoStyle preset: Auto or specific styles (default: Auto).
aspect_ratioNoOutput aspect ratio (default: 1:1).
enable_base64_outputNoReturn base64 string instead of URL (API only).

Supported Aspect Ratios

Aspect RatioBest For
1:1Instagram posts, social media squares
16:9YouTube thumbnails, widescreen displays
9:16TikTok, Instagram Stories, mobile content
4:3Classic format, presentations
3:4Portrait photos, Pinterest

How to Use

Text-to-Image:

  1. Write a prompt describing the image you want. Use the Prompt Enhancer for AI-assisted optimization.
  2. Select a style preset or use Auto.
  3. Choose your desired aspect ratio.
  4. Click Run and download your image.

Image-to-Image:

  1. Upload a source image.
  2. Write a prompt describing the transformation.
  3. Adjust style and aspect ratio as needed.
  4. Click Run and download your image.

Inpainting:

  1. Upload a source image and a mask image.
  2. White areas in the mask will be regenerated based on your prompt.
  3. Write a prompt describing what should appear in the masked region.
  4. Click Run and download your image.

Best Use Cases

  • Typography & Posters — Create posters, banners, and designs with accurate, stylized text.
  • Logo Design — Generate logo concepts with readable brand names.
  • Product Mockups — Create realistic product images with custom text and branding.
  • Social Media Graphics — Produce text-heavy visuals for posts and ads.
  • Marketing Materials — Create promotional images with integrated messaging.
  • Signage & Labels — Generate realistic signs, storefronts, and product labels.

Pricing

OutputPrice
Per image$0.08

Pro Tips for Best Quality

  • For text rendering, include the exact text in quotes within your prompt.
  • Specify font style if desired (e.g., “bold sans-serif,” “elegant script,” “neon sign”).
  • Use the inpainting feature with masks to edit specific areas while preserving the rest.
  • Choose an appropriate style preset to match your creative vision.
  • Select the right aspect ratio for your intended use.

Notes

  • Ensure uploaded image URLs are publicly accessible.
  • Processing time varies based on current queue load.
  • Please ensure your prompts comply with content guidelines.

Features

https://docs.ideogram.ai/using-ideogram/ideogram-features

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-v2" \
--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

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagestringNo-The image to generate an image from.
mask_imagestringNo-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.
stylestringNoAutoAuto, General, Realistic, Design, Render 3D, AnimeThe style of the generated image.
aspect_ratiostringNo1:11:1, 16:9, 9:16, 4:3, 3:4The aspect ratio of the generated media.
enable_base64_outputbooleanNofalse-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

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.