---
title: "Changes to Replace an image background"
method: POST
path: "/v2/image/replace-background/gpt-image-2"
---

# Changes to Replace an image background

`POST /v2/image/replace-background/gpt-image-2`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 33 revisions.

- **2026-09-27** `987f73fc82de` — 4 info
- **2026-09-23** `cdaa218128ba` — 2 breaking, 2 warning
- **2026-09-19** `4e95197be44a` — 6 breaking, 8 info
- **2026-09-16** `a235a15c0235` — 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-23** `cdaa218128ba` — 2 breaking, 2 warning
  - added `#/components/schemas/ReplaceBackgroundQuality` to the `quality` request property `allOf` list (media type: multipart/form-data)
  - added `#/components/schemas/ReplaceBackgroundQuality` to the `quality` request property `allOf` list (media type: application/json)
  - removed `#/components/schemas/GptImage2Quality` from the `quality` request property `allOf` list (media type: multipart/form-data)
  - removed `#/components/schemas/GptImage2Quality` from the `quality` request property `allOf` list (media type: application/json)
- **2026-09-19** `4e95197be44a` — 6 breaking, 8 info
  - removed the enum value `HIGH` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - removed the enum value `HIGH` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
  - removed the enum value `LOW` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - removed the enum value `LOW` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
  - removed the enum value `MEDIUM` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - removed the enum value `MEDIUM` of the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
  - the `quality` request property default value changed from `HIGH` to `high` (media type: multipart/form-data)
  - the `quality` request property default value changed from `HIGH` to `high` (media type: application/json)
  - added the new `high` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - added the new `high` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
  - added the new `low` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - added the new `low` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
  - added the new `medium` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: multipart/form-data)
  - added the new `medium` enum value to the request property `quality/allOf[subschema #1: GptImage2Quality]/` (media type: application/json)
- **2026-09-16** `a235a15c0235` — 1 info
  - endpoint added

---

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