Image models
Ideogram Character
On this page
Ideogram Character — fast, high-fidelity AI image generation & editing.
| modelId | ideogram-character |
| 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. |
| Image to image | POST /api/v1/generate | Condition on a reference image — upload it via /api/v1/files/upload and pass the URL. |
| Poll task | GET /api/v1/task/{id}?model=ideogram-character | Retrieve state and result URLs. |
Input parameters
| Field | Type | Required | Values / example |
|---|---|---|---|
| prompt | textarea | required | Place the woman leisurely enjoying a cup of espresso while relaxing at a sunlit café table in Siena, Italy... |
| reference_image_urls | image | required | Drag and drop or click to upload your file |
| rendering_speed | select | optional | TURBO, BALANCED, QUALITY |
| style | select | optional | AUTO, REALISTIC, FICTION |
| expand_prompt | select | optional | false, true |
| num_images | select | optional | 1, 2, 3, 4 |
| image_size | select | optional | square, square_hd, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 |
| seed | number | optional | Enter number... |
| negative_prompt | textarea | optional | Description of what to exclude from an 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-character","input":{"prompt":"The same character as a cinematic studio portrait, soft golden rim light, shallow depth of field, clean and tasteful composition.","rendering_speed":"BALANCED","style":"AUTO","expand_prompt":"true","num_images":"1","image_size":"square_hd","seed":8,"negative_prompt":"…","nsfw_checker":"true"}}'