> 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 remix endpoints: transform an existing image with a prompt, control how closely the result follows it with image_weight, and choose a model.

Remix makes a new image from a source image and a prompt: `POST /v2/image/remix/{model}`. Send the source as `image` in a `multipart/form-data` request.

`image_weight`, from 1 to 100, sets how closely the result follows the source image. Leave it out and the model uses its usual strength.

| Endpoint                    | Choose it for                                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `auto`                      | Letting Ideogram pick the model, at a `resolution_tier` of 1k or 2k                                             |
| `ideogram-4-5`              | Steering the result with up to 4 `reference_images` as well as the source, at `low`, `medium` or `high` quality |
| `ideogram-4`                | Ideogram 4.0 styling, with `rendering_speed`                                                                    |
| `ideogram-3`                | Ideogram 3.0 style types, presets and up to 10 `style_reference_images`                                         |
| `ideogram-3-character`      | Putting one character from `character_reference_images` into the image                                          |
| `ideogram-3-custom-model`   | A custom Ideogram 3.0 model, by `custom_model_uri`                                                              |
| `ideogram-2`, `ideogram-2a` | Existing integrations                                                                                           |

To change one part of an image and keep everything else, use [Precise Edit](/v2/api-reference/images/precise-edit/ideogram-4-5) or [Inpaint](/v2/api-reference/images/inpaint/ideogram-3) with a mask instead. See [Edit one region with a mask](/v2/ideogram-api/masked-edits).

In the app, see [Remix](https://docs.ideogram.ai/edit/remix) in the user guide.