---
title: "Changes to Generate transparent-background images with Ideogram 4.0"
method: POST
path: "/v2/image/generate/ideogram-4-transparent"
---

# Changes to Generate transparent-background images with Ideogram 4.0

`POST /v2/image/generate/ideogram-4-transparent`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 33 revisions.

- **2026-09-27** `987f73fc82de` — 4 info
- **2026-09-19** `4e95197be44a` — 9 breaking, 1 warning, 12 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-19** `4e95197be44a` — 9 breaking, 1 warning, 12 info
  - added `#/components/schemas/MagicPromptMode` to the `magic_prompt` request property `allOf` list
  - removed the enum value `1K` of the request property `output_resolution`
  - removed the enum value `2K` of the request property `output_resolution`
  - removed the enum value `4K` of the request property `output_resolution`
  - removed the enum value `8K` of the request property `output_resolution`
  - removed the enum value `AUTO` of the request property `aspect_ratio`
  - removed the enum value `DEFAULT` of the request property `rendering_speed`
  - removed the enum value `QUALITY` of the request property `rendering_speed`
  - removed the enum value `TURBO` of the request property `rendering_speed`
  - removed `#/components/schemas/MagicPromptOption` from the `magic_prompt` request property `allOf` list
  - the `aspect_ratio` request property default value changed from `AUTO` to `auto`
  - the `magic_prompt` request property default value changed from `AUTO` to `auto`
  - the `output_resolution` request property default value changed from `1K` to `1k`
  - the `rendering_speed` request property default value changed from `DEFAULT` to `default`
  - added the new `1k` enum value to the request property `output_resolution`
  - added the new `2k` enum value to the request property `output_resolution`
  - added the new `4k` enum value to the request property `output_resolution`
  - added the new `8k` enum value to the request property `output_resolution`
  - added the new `auto` enum value to the request property `aspect_ratio`
  - added the new `default` enum value to the request property `rendering_speed`
  - added the new `quality` enum value to the request property `rendering_speed`
  - added the new `turbo` enum value to the request property `rendering_speed`
- **2026-09-17** `9d3ff2d98e27` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ideogram/apis/ideogram-openapi-3-0/docs/v2/image/generate/ideogram-4-transparent/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-4-transparent/post)