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

# Changes to Create image variation

`POST /images/variations`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 163 revisions.

- **2026-09-25** `d86203de41ae` — 5 info
- **2026-09-08** `185927e212ab` — 1 breaking, 2 warning, 4 info
- **2026-05-13** `74cbcf73838f` — 5 info
- **2025-04-29** `6a6c681b1820` — 2 breaking, 1 info

## Changes

- **2026-09-25** `d86203de41ae` — 5 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 `429`
  - added the non-success response with the status `500`
- **2026-09-08** `185927e212ab` — 1 breaking, 2 warning, 4 info
  - the `size` response's property type changed from `string` to no type for status `200`
  - added the new `max` enum value to the `quality` response property for the response status `200`
  - added the new `xhigh` enum value to the `quality` response property for the response status `200`
  - added `subschema #1, subschema #2` to the `size` response property `anyOf` list for the response status `200`
  - removed the `1024x1024` enum value from the `size` response property for the response status `200`
  - removed the `1024x1536` enum value from the `size` response property for the response status `200`
  - removed the `1536x1024` enum value from the `size` response property for the response status `200`
- **2026-05-13** `74cbcf73838f` — 5 info
  - 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, 1 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 optional property `usage` to the response with the `200` status

---

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