Skip to navigation

Model Lifecycle and Deprecations

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

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:

SignalExampleWhen
Link header (RFC 8288)<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)@1777420800, the Unix time the endpoint was deprecatedOnly when the endpoint is deprecated
notice field in the JSON bodyThis 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:

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 endpointReplacement
POST /v1/ideogram-v4/generate, POST /v1/ideogram-v4/async/generatePOST /v2/image/generate/ideogram-4
POST /v1/ideogram-v4/generate-transparent, POST /v1/ideogram-v4/async/generate-transparentPOST /v2/image/generate/ideogram-4-transparent
POST /v1/ideogram-v4/remixPOST /v2/image/remix/ideogram-4
POST /v1/ideogram-v4/describePOST /v2/image/describe/ideogram-4
POST /v1/ideogram-v3/generatePOST /v2/image/generate/ideogram-3
POST /v1/ideogram-v3/generate-transparentPOST /v2/image/generate/ideogram-3-transparent
POST /v1/ideogram-v3/remixPOST /v2/image/remix/ideogram-3
POST /v1/ideogram-v3/inpaint, POST /v1/ideogram-v3/edit (deprecated)POST /v2/image/inpaint/ideogram-3
POST /v1/ideogram-v3/reframePOST /v2/image/reframe/ideogram-3
POST /v1/ideogram-v3/replace-backgroundPOST /v2/image/replace-background/ideogram-3
POST /v1/ideogram-v3/layerize-textPOST /v2/design/layerize/ideogram-3
POST /v1/text-to-image/p-image-ideogram, POST /v1/async/text-to-image/p-image-ideogramPOST /v2/image/generate/p-image-ideogram
POST /v1/editPOST /v2/image/precise-edit/ideogram-4-5
POST /v1/remove-backgroundPOST /v2/image/remove-background/ideogram-1
POST /v1/remove-objectPOST /v2/image/remove-object/ideogram-1
POST /v1/async/ad-resizerPOST /v2/tool/ad-resizer
POST /generatePOST /v2/image/generate/ideogram-4-5
POST /remixPOST /v2/image/remix/auto
POST /editPOST /v2/image/inpaint/ideogram-3
POST /describePOST /v2/image/describe/ideogram-4
POST /reframePOST /v2/image/reframe/ideogram-3
POST /upscalePOST /v2/image/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 for the v2 request pattern.