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. UsePOST /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
Deprecationheader 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:
Log these in your client so an older endpoint doesn’t go unnoticed:
Replacements
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.