Image models
Ideogram V3
On this page
Ideogram V3 — fast, high-fidelity AI image generation & editing.
| modelId | ideogram-v3-text-to-image |
| Modality | image |
| Pricing | See this model on the Pricing page for the current per-call price (with your markup). |
Operations
| Operation | Endpoint | Description |
|---|---|---|
| Text to image | POST /api/v1/generate | Base generation from a text prompt. |
| Poll task | GET /api/v1/task/{id}?model=ideogram-v3-text-to-image | Retrieve state and result URLs. |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | textarea | required | Describe the image you want to generate... |
| rendering_speed | select | optional | TURBO, BALANCED, QUALITY |
| style | select | optional | AUTO, GENERAL, REALISTIC, DESIGN |
| expand_prompt | select | optional | false, true |
| image_size | select | optional | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| seed | number | optional | Enter seed number... |
| negative_prompt | textarea | optional | Describe what you want to exclude from the image... |
| nsfw_checker | select | optional | false, true |
Example request
bash
curl -X POST https://you.bot/api/v1/generate \
-H "Authorization: Bearer $YOUBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"modelId":"ideogram-v3-text-to-image","input":{"prompt":"Vintage travel poster of a mountain railway with the headline 'TAKE THE SLOW TRAIN' in art-deco lettering, dusk palette.","rendering_speed":"BALANCED","style":"AUTO","expand_prompt":"true","image_size":"square_hd","seed":8,"negative_prompt":"…","nsfw_checker":"true"}}'