Ideogram Ai Ideogram V2A Turbo
Playground
Try it on WavespeedAI!Ideogram v2a Turbo is an image model with state-of-the-art inpainting, strong prompt comprehension, and high-fidelity text rendering. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
Ideogram V2a Turbo
Generate versatile images with exceptional typography using Ideogram V2a Turbo. This fast, flexible model offers expanded style options including 3D rendering and anime — perfect for diverse creative projects from realistic photos to stylized illustrations.
Looking for the latest version? Try Ideogram V3 Turbo for the newest generation.
Why It Looks Great
- Expanded styles: Six style presets including Render 3D and Anime modes.
- Superior typography: Industry-leading text rendering for posters, logos, and designs.
- Fast generation: Turbo speed for rapid iteration and testing.
- Multiple modes: Text-to-image generation, image editing, and masked inpainting.
- 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, Design, Render 3D, or Anime. Default: Auto. |
| aspect_ratio | No | Output format: 1:1, 16:9, 9:16, 4:3, or 3:4. Default: 1:1. |
| 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 from six style presets.
- Set aspect ratio — pick the format that fits your use case.
- 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.04 |
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 |
| Render 3D | 3D rendered appearance | Product renders, 3D scenes, objects |
| Anime | Japanese animation style | Anime characters, manga, illustrations |
Best Use Cases
- 3D Product Visualization — Create 3D-style product renders and mockups.
- Anime & Illustration — Generate anime characters and manga-style artwork.
- Typography & Posters — Create designs with perfectly rendered text.
- Mixed Media Projects — Switch between styles for diverse creative needs.
- Rapid Prototyping — Test concepts quickly across different visual styles.
Example Prompts
- “3D render of a sleek wireless headphone, studio lighting, product showcase, floating on gradient background”
- “anime girl with blue hair and cat ears, cherry blossom background, text saying ‘KAWAII’, vibrant colors”
- “realistic portrait photo of a businessman, professional headshot, neutral background”
- “modern logo design for tech startup ‘NEXUS AI’, futuristic, clean typography”
- “isometric 3D illustration of a cozy bedroom, warm lighting, detailed furniture”
Pro Tips for Best Results
- Use Render 3D for product mockups, isometric illustrations, and 3D-style scenes.
- Use Anime for character art, manga panels, and Japanese illustration styles.
- For typography, put the exact text in quotes within your prompt.
- V2a offers more style variety than V3 — great for stylized content.
- Use masks to selectively edit only specific areas of an image.
- Turbo speed is ideal for testing before committing to higher-quality generation.
Notes
- Ideogram is renowned for best-in-class text rendering in AI-generated images.
- V2a offers Render 3D and Anime styles not available in V3.
- If using URLs for images, ensure they are publicly accessible.
- The enable_base64_output option is only available through the API.
- Enable Safety Checker for content that will be publicly shared.
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-v2a-turbo" \
--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, Render 3D, Anime | 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. |
| 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 |