> 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.

> Which Ideogram API endpoints are older or deprecated, the v2 endpoint that replaces each, and the Link, Deprecation and notice signals they return.

Ideogram adds models and endpoints over time. When a v2 endpoint replaces an older one, the older endpoint keeps working, and its responses name the replacement. This page lists every replacement and the one deprecated endpoint.

## Current status

* **No v2 endpoint is deprecated.** Ideogram 2.0 and 2a are still available in v2.
* **One endpoint is deprecated:** `POST /v1/ideogram-v3/edit`, since April 29, 2026. Use [`POST /v2/image/inpaint/ideogram-3`](/v2/api-reference/images/inpaint/ideogram-3).
* **Every other v1 endpoint with a v2 replacement is an older version.** It keeps working, and new features arrive in v2.
* **No endpoint has a removal date.** Check this page and the `Deprecation` header for an endpoint's status.
* **Custom model training stays on v1.** v2 has no training endpoints; it generates with models you have already trained. See the [v1 training tutorial](/v1/tutorials/custom-model-training).

## How an older endpoint tells you

A response from an endpoint that has a replacement carries three signals, so code and coding agents can find the replacement without reading these docs:

| Signal                                                                    | Example                                                                                               | When                                               |
| ------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| `Link` header ([RFC 8288](https://www.rfc-editor.org/rfc/rfc8288))        | `<https://developer.ideogram.ai/v2/api-reference/images/inpaint/ideogram-3>; rel="successor-version"` | Every response from an endpoint with a replacement |
| `Deprecation` header ([RFC 9745](https://www.rfc-editor.org/rfc/rfc9745)) | `@1777420800`, the Unix time the endpoint was deprecated                                              | Only when the endpoint is deprecated               |
| `notice` field in the JSON body                                           | `This endpoint is deprecated. Use POST /v2/image/inpaint/ideogram-3 instead: ...`                     | Successful JSON responses                          |

Log these in your client so an older endpoint doesn't go unnoticed:

```python
import logging

import requests


def warn_if_older(response: requests.Response) -> None:
  successor = response.links.get("successor-version", {}).get("url")
  if successor:
    logging.warning(
      "%s has a newer replacement: %s (Deprecation: %s)",
      response.request.url,
      successor,
      response.headers.get("Deprecation", "not deprecated"),
    )
```

## Replacements

| Older endpoint                                                                                 | Replacement                                                                                                  |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `POST /v1/ideogram-v4/generate`, `POST /v1/ideogram-v4/async/generate`                         | [`POST /v2/image/generate/ideogram-4`](/v2/api-reference/images/generate/ideogram-4)                         |
| `POST /v1/ideogram-v4/generate-transparent`, `POST /v1/ideogram-v4/async/generate-transparent` | [`POST /v2/image/generate/ideogram-4-transparent`](/v2/api-reference/images/generate/ideogram-4-transparent) |
| `POST /v1/ideogram-v4/remix`                                                                   | [`POST /v2/image/remix/ideogram-4`](/v2/api-reference/images/remix/ideogram-4)                               |
| `POST /v1/ideogram-v4/describe`                                                                | [`POST /v2/image/describe/ideogram-4`](/v2/api-reference/images/describe/ideogram-4)                         |
| `POST /v1/ideogram-v3/generate`                                                                | [`POST /v2/image/generate/ideogram-3`](/v2/api-reference/images/generate/ideogram-3)                         |
| `POST /v1/ideogram-v3/generate-transparent`                                                    | [`POST /v2/image/generate/ideogram-3-transparent`](/v2/api-reference/images/generate/ideogram-3-transparent) |
| `POST /v1/ideogram-v3/remix`                                                                   | [`POST /v2/image/remix/ideogram-3`](/v2/api-reference/images/remix/ideogram-3)                               |
| `POST /v1/ideogram-v3/inpaint`, `POST /v1/ideogram-v3/edit` (deprecated)                       | [`POST /v2/image/inpaint/ideogram-3`](/v2/api-reference/images/inpaint/ideogram-3)                           |
| `POST /v1/ideogram-v3/reframe`                                                                 | [`POST /v2/image/reframe/ideogram-3`](/v2/api-reference/images/reframe/ideogram-3)                           |
| `POST /v1/ideogram-v3/replace-background`                                                      | [`POST /v2/image/replace-background/ideogram-3`](/v2/api-reference/images/replace-background/ideogram-3)     |
| `POST /v1/ideogram-v3/layerize-text`                                                           | [`POST /v2/design/layerize/ideogram-3`](/v2/api-reference/images/layerize/ideogram-3)                        |
| `POST /v1/text-to-image/p-image-ideogram`, `POST /v1/async/text-to-image/p-image-ideogram`     | [`POST /v2/image/generate/p-image-ideogram`](/v2/api-reference/images/generate/p-image-ideogram)             |
| `POST /v1/edit`                                                                                | [`POST /v2/image/precise-edit/ideogram-4-5`](/v2/api-reference/images/precise-edit/ideogram-4-5)             |
| `POST /v1/remove-background`                                                                   | [`POST /v2/image/remove-background/ideogram-1`](/v2/api-reference/images/remove-background/ideogram-1)       |
| `POST /v1/remove-object`                                                                       | [`POST /v2/image/remove-object/ideogram-1`](/v2/api-reference/images/remove-object/ideogram-1)               |
| `POST /v1/async/ad-resizer`                                                                    | [`POST /v2/tool/ad-resizer`](/v2/api-reference/tools/ad-resizer)                                             |
| `POST /generate`                                                                               | [`POST /v2/image/generate/ideogram-4-5`](/v2/api-reference/images/generate/ideogram-4-5)                     |
| `POST /remix`                                                                                  | [`POST /v2/image/remix/auto`](/v2/api-reference/images/remix/auto)                                           |
| `POST /edit`                                                                                   | [`POST /v2/image/inpaint/ideogram-3`](/v2/api-reference/images/inpaint/ideogram-3)                           |
| `POST /describe`                                                                               | [`POST /v2/image/describe/ideogram-4`](/v2/api-reference/images/describe/ideogram-4)                         |
| `POST /reframe`                                                                                | [`POST /v2/image/reframe/ideogram-3`](/v2/api-reference/images/reframe/ideogram-3)                           |
| `POST /upscale`                                                                                | [`POST /v2/image/upscale/auto`](/v2/api-reference/images/upscale/auto)                                       |

Request fields differ between versions in places. For example, v1's `text_prompt` is v2's `prompt`. Check the replacement's reference before you switch, and see [Moving from v1](/v2/ideogram-api/api-overview#moving-from-v1) for the v2 request pattern.