---
title: "Creates a variation of a given image."
method: POST
path: "/images/variations"
tags: ["Images"]
---

# Creates a variation of a given image.

`POST /images/variations`

## Response `200`

OK

- ImagesResponse
  - `created` integer, required
  - `data` Image[], required
    - `b64_json` string — The base64-encoded JSON of the generated image, if `response_format` is `b64_json`.
    - `url` string — The URL of the generated image, if `response_format` is `url` (default).
    - `revised_prompt` string — The prompt that was used to generate the image, if there was any revision to the prompt.

## Changes

- **2024-08-23** `5856f8b0c850` — 3 breaking, 5 warning, 1 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - the `created` response's property type/format changed from `integer`/`unixtime` to `integer`/`` for status `200`
  - the `data/items/url` response's property type/format changed from `string`/`uri` to `string`/`` for status `200`
  - removed the optional property `background` from the response with the `200` status
  - …5 more

[Change history](https://skmtc.dev/openai/apis/openapi/changes/images/variations/post.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/openapi/revisions/96060afbb5b9/schema)