---
title: "Changes to Generate images with Ideogram 3.0 from a text prompt"
method: POST
path: "/v2/image/generate/ideogram-3"
---

# Changes to Generate images with Ideogram 3.0 from a text prompt

`POST /v2/image/generate/ideogram-3`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 34 revisions.

- **2026-09-27** `987f73fc82de` — 4 info
- **2026-09-25** `52c1c6497d87` — 2 info
- **2026-09-19** `4e95197be44a` — 30 breaking, 4 warning, 28 info
- **2026-09-17** `9d3ff2d98e27` — 1 info

## Changes

- **2026-09-27** `987f73fc82de` — 4 info
  - added the optional property `max_inflight_requests` to the response with the `402` status
  - added the optional property `max_inflight_requests` to the response with the `429` status
  - added the optional property `task_completion_speed` to the response with the `402` status
  - added the optional property `task_completion_speed` to the response with the `429` status
- **2026-09-25** `52c1c6497d87` — 2 info
  - added the new `auto` enum value to the request property `aspect_ratio` (media type: multipart/form-data)
  - added the new `auto` enum value to the request property `aspect_ratio` (media type: application/json)
- **2026-09-19** `4e95197be44a` — 30 breaking, 4 warning, 28 info
  - added `#/components/schemas/IdeogramV3StylePreset` to the `style_preset` request property `allOf` list (media type: multipart/form-data)
  - added `#/components/schemas/IdeogramV3StylePreset` to the `style_preset` request property `allOf` list (media type: application/json)
  - added `#/components/schemas/MagicPromptMode` to the `magic_prompt` request property `allOf` list (media type: multipart/form-data)
  - added `#/components/schemas/MagicPromptMode` to the `magic_prompt` request property `allOf` list (media type: application/json)
  - removed the enum value `AUTO` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `AUTO` of the request property `style_type` (media type: application/json)
  - removed the enum value `BALANCED` of the request property `rendering_speed` (media type: multipart/form-data)
  - removed the enum value `BALANCED` of the request property `rendering_speed` (media type: application/json)
  - removed the enum value `CUSTOM` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `CUSTOM` of the request property `style_type` (media type: application/json)
  - removed the enum value `DEFAULT` of the request property `rendering_speed` (media type: multipart/form-data)
  - removed the enum value `DEFAULT` of the request property `rendering_speed` (media type: application/json)
  - removed the enum value `DESIGN` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `DESIGN` of the request property `style_type` (media type: application/json)
  - removed the enum value `FICTION` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `FICTION` of the request property `style_type` (media type: application/json)
  - removed the enum value `FLASH` of the request property `rendering_speed` (media type: multipart/form-data)
  - removed the enum value `FLASH` of the request property `rendering_speed` (media type: application/json)
  - removed the enum value `GENERAL` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `GENERAL` of the request property `style_type` (media type: application/json)
  - removed the enum value `QUALITY` of the request property `rendering_speed` (media type: multipart/form-data)
  - removed the enum value `QUALITY` of the request property `rendering_speed` (media type: application/json)
  - removed the enum value `REALISTIC` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `REALISTIC` of the request property `style_type` (media type: application/json)
  - removed the enum value `STYLIZED` of the request property `style_type` (media type: multipart/form-data)
  - removed the enum value `STYLIZED` of the request property `style_type` (media type: application/json)
  - removed the enum value `TURBO` of the request property `rendering_speed` (media type: multipart/form-data)
  - removed the enum value `TURBO` of the request property `rendering_speed` (media type: application/json)
  - removed `#/components/schemas/ColorPaletteWithPresetName` from the `color_palette` request property `oneOf` list (media type: multipart/form-data)
  - removed `#/components/schemas/ColorPaletteWithPresetName` from the `color_palette` request property `oneOf` list (media type: application/json)
  - removed `#/components/schemas/MagicPromptOption` from the `magic_prompt` request property `allOf` list (media type: multipart/form-data)
  - removed `#/components/schemas/MagicPromptOption` from the `magic_prompt` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/StylePresetV3` from the `style_preset` request property `allOf` list (media type: multipart/form-data)
  - removed `#/components/schemas/StylePresetV3` from the `style_preset` request property `allOf` list (media type: application/json)
  - the `magic_prompt` request property default value changed from `AUTO` to `auto` (media type: multipart/form-data)
  - the `magic_prompt` request property default value changed from `AUTO` to `auto` (media type: application/json)
  - the `rendering_speed` request property default value changed from `DEFAULT` to `default` (media type: multipart/form-data)
  - the `rendering_speed` request property default value changed from `DEFAULT` to `default` (media type: application/json)
  - the `style_type` request property default value changed from `GENERAL` to `general` (media type: multipart/form-data)
  - the `style_type` request property default value changed from `GENERAL` to `general` (media type: application/json)
  - …22 more
- **2026-09-17** `9d3ff2d98e27` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/docs/v2/image/generate/ideogram-3/post.md) · [API](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0.md) · [Page](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/changes/v2/image/generate/ideogram-3/post)
