---
title: "Changes to Create image"
method: POST
path: "/images/generations"
---

# Changes to Create image

`POST /images/generations`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 164 revisions.

- **2026-09-25** `d86203de41ae` — 4 info
- **2026-09-08** `185927e212ab` — 1 breaking, 6 warning, 20 info
- **2026-09-03** `9430b00d75b4` — 2 info
- **2026-09-03** `5f6acbcbb919` — 2 info
- **2026-08-20** `5de4ab93fa24` — 2 info
- **2026-05-13** `74cbcf73838f` — 9 breaking, 11 info
- **2025-04-29** `6a6c681b1820` — 2 breaking, 16 info

## Changes

- **2026-09-25** `d86203de41ae` — 4 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `410`
  - added the non-success response with the status `500`
- **2026-09-08** `185927e212ab` — 1 breaking, 6 warning, 20 info
  - the `size` response's property type changed from `string` to no type for status `200` (media type: application/json)
  - added the new `max` enum value to the `anyOf[#/components/schemas/ImageGenCompletedEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `max` enum value to the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `max` enum value to the `quality` response property for the response status `200` (media type: application/json)
  - added the new `xhigh` enum value to the `anyOf[#/components/schemas/ImageGenCompletedEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `xhigh` enum value to the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/quality` response property for the response status `200` (media type: text/event-stream)
  - added the new `xhigh` enum value to the `quality` response property for the response status `200` (media type: application/json)
  - added the new `gpt-image-2.5-flare` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-flare-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-sunburst` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2.5-sunburst-2026-09-08` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `max` enum value to the request property `quality`
  - added the new `xhigh` enum value to the request property `quality`
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/ImageGenCompletedEvent]/size` response property `anyOf` list for the response status `200` (media type: text/event-stream)
  - added `subschema #1, subschema #2` to the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/size` response property `anyOf` list for the response status `200` (media type: text/event-stream)
  - added `subschema #1, subschema #2` to the `size` response property `anyOf` list for the response status `200` (media type: application/json)
  - removed the `1024x1024` enum value from the `anyOf[#/components/schemas/ImageGenCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1024` enum value from the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1024` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `1024x1536` enum value from the `anyOf[#/components/schemas/ImageGenCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1536` enum value from the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1024x1536` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `1536x1024` enum value from the `anyOf[#/components/schemas/ImageGenCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1536x1024` enum value from the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `1536x1024` enum value from the `size` response property for the response status `200` (media type: application/json)
  - removed the `auto` enum value from the `anyOf[#/components/schemas/ImageGenCompletedEvent]/size` response property for the response status `200` (media type: text/event-stream)
  - removed the `auto` enum value from the `anyOf[#/components/schemas/ImageGenPartialImageEvent]/size` response property for the response status `200` (media type: text/event-stream)
- **2026-09-03** `9430b00d75b4` — 2 info
  - added the optional property `error/misalignment` to the response with the `429` status
  - added the optional property `error/misalignment` to the response with the `503` status
- **2026-09-03** `5f6acbcbb919` — 2 info
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
- **2026-08-20** `5de4ab93fa24` — 2 info
  - added the new `gpt-image-2` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-2-2026-04-21` enum value to the request property `model/anyOf[subschema #2]/`
- **2026-05-13** `74cbcf73838f` — 9 breaking, 11 info
  - removed the enum value `1024x1024` of the request property `size`
  - removed the enum value `1024x1536` of the request property `size`
  - removed the enum value `1024x1792` of the request property `size`
  - removed the enum value `1536x1024` of the request property `size`
  - removed the enum value `1792x1024` of the request property `size`
  - removed the enum value `256x256` of the request property `size`
  - removed the enum value `512x512` of the request property `size`
  - removed the enum value `auto` of the request property `size`
  - the `size` request property type changed from `string` to no type
  - added the new optional request property `partial_images`
  - added the new optional request property `stream`
  - added `subschema #1, subschema #2` to the `size` request property `anyOf` list
  - added the new `gpt-image-1-mini` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-image-1.5` enum value to the request property `model/anyOf[subschema #2]/`
  - added the media type `text/event-stream` for the response with the status `200`
  - added the optional property `background` to the response with the `200` status
  - added the optional property `output_format` to the response with the `200` status
  - added the optional property `quality` to the response with the `200` status
  - added the optional property `size` to the response with the `200` status
  - added the optional property `usage/output_tokens_details` to the response with the `200` status
- **2025-04-29** `6a6c681b1820` — 2 breaking, 16 info
  - the response's body type changed from no type to `object` for status `200`
  - the response property `data` became optional for the status `200`
  - added the new optional request property `background`
  - added the new optional request property `moderation`
  - added the new optional request property `output_compression`
  - added the new optional request property `output_format`
  - the request property `quality` became nullable
  - the `quality` request property default value changed from `standard` to `auto`
  - the `size` request property default value changed from `1024x1024` to `auto`
  - added the new `1024x1536` enum value to the request property `size`
  - added the new `1536x1024` enum value to the request property `size`
  - added the new `auto` enum value to the request property `quality`
  - added the new `auto` enum value to the request property `size`
  - added the new `gpt-image-1` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `high` enum value to the request property `quality`
  - added the new `low` enum value to the request property `quality`
  - added the new `medium` enum value to the request property `quality`
  - added the optional property `usage` to the response with the `200` status

---

[Operation](https://skmtc.dev/openai/apis/openapi/docs/images/generations/post.md) · [API](https://skmtc.dev/openai/apis/openapi.md) · [Page](https://skmtc.dev/openai/apis/openapi/changes/images/generations/post)