> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developer.ideogram.ai/v2/llms.txt
> - v1: https://developer.ideogram.ai/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.ideogram.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.ideogram.ai/_mcp/server.

> Ideogram API image generation endpoints: one endpoint per model, the fields they share, synchronous and asynchronous requests, and how to choose a model.

Each generate endpoint runs one model: `POST /v2/image/generate/{model}`. They share a request shape, so switching models usually means changing the path and the model's own options.

## Fields every generate endpoint takes

| Field         | What it does                                                                                                                                                                     |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`      | What to generate, up to 10,000 characters. Ideogram 4.6, 4.5, 4.0 and P-Image Ideogram also accept a [structured JSON prompt](https://docs.ideogram.ai/prompting/json-prompting) |
| `num_images`  | 1 to 8 images per request                                                                                                                                                        |
| `async`       | Return a `generation_id` straight away instead of waiting. Poll [`GET /v2/generations/{generation_id}`](/v2/api-reference/generations/get-generation) for the result             |
| `webhook_url` | Receive the result at your HTTPS endpoint. Every endpoint except `auto` takes it. See [Webhooks](/v2/ideogram-api/webhooks)                                                      |

Most models also take `seed`, `aspect_ratio` or a size field, and their own quality or speed setting. Each endpoint's page lists every field.

## Edit with a prompt

`auto`, Ideogram 4.6, Ideogram 4.5, GPT Image and Nano Banana also accept source `images` in a `multipart/form-data` request. The prompt then describes the change to make. To change one region and keep the image's exact size, use [Precise Edit](/v2/api-reference/images/precise-edit/ideogram-4-5).

## Choose a model

[Choose a model](/v2/ideogram-api/models#image-generation-models) compares the models' inputs, controls and prices. Start with Ideogram 4.5, or send the request to `auto` and let Ideogram pick.

The same models run in the Ideogram app. See [Models](https://docs.ideogram.ai/create/models) and [Create Images](https://docs.ideogram.ai/create/create) in the user guide.