---
title: "Changes to Refine an image"
method: POST
path: "/v3/ai/image-generations/refine"
---

# Changes to Refine an image

`POST /v3/ai/image-generations/refine`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 16 revisions.

- **2026-07-13** `29f239eeae86`: 9 info
- **2025-11-20** `81cb0e852242`: 10 breaking, 3 warning
- **2025-03-07** `328d929c7310`: 1 info
- **2024-11-23** `f751fa2a43c9`: 9 breaking, 3 warning, 9 info
- **2024-08-26** `00000cbae4c7`: 1 info

## Changes

- **2026-07-13** `29f239eeae86`: 9 info
  - the request property `mask_url` became nullable (media type: application/json)
  - the request property `mask_url` became nullable (media type: text/json)
  - the request property `mask_url` became nullable (media type: application/*+json)
  - the request property `mask_url` became optional (media type: application/json)
  - the request property `mask_url` became optional (media type: text/json)
  - the request property `mask_url` became optional (media type: application/*+json)
  - the `mask_url` request property's minLength was decreased from `1` to `0` (media type: application/json)
  - the `mask_url` request property's minLength was decreased from `1` to `0` (media type: text/json)
  - the `mask_url` request property's minLength was decreased from `1` to `0` (media type: application/*+json)
- **2025-11-20** `81cb0e852242`: 10 breaking, 3 warning
  - the request property `prompt` became not nullable (media type: application/json)
  - the request property `prompt` became not nullable (media type: text/json)
  - the request property `prompt` became not nullable (media type: application/*+json)
  - the request property `prompt` became required (media type: application/json)
  - the request property `prompt` became required (media type: text/json)
  - the request property `prompt` became required (media type: application/*+json)
  - the `prompt` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `prompt` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `prompt` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - removed the success response with the status `200`
  - removed the request property `negative_prompt` (media type: application/json)
  - removed the request property `negative_prompt` (media type: text/json)
  - removed the request property `negative_prompt` (media type: application/*+json)
- **2025-03-07** `328d929c7310`: 1 info
  - added the non-success response with the status `409`
- **2024-11-23** `f751fa2a43c9`: 9 breaking, 3 warning, 9 info
  - the request property `mask_url` became not nullable (media type: application/json)
  - the request property `mask_url` became not nullable (media type: text/json)
  - the request property `mask_url` became not nullable (media type: application/*+json)
  - the request property `mask_url` became required (media type: application/json)
  - the request property `mask_url` became required (media type: text/json)
  - the request property `mask_url` became required (media type: application/*+json)
  - the `mask_url` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `mask_url` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `mask_url` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - removed the request property `id` (media type: application/json)
  - removed the request property `id` (media type: text/json)
  - removed the request property `id` (media type: application/*+json)
  - added the new optional request property `reference_asset_id` (media type: application/json)
  - added the new optional request property `reference_asset_id` (media type: text/json)
  - added the new optional request property `reference_asset_id` (media type: application/*+json)
  - added the new optional request property `reference_generation` (media type: application/json)
  - added the new optional request property `reference_generation` (media type: text/json)
  - added the new optional request property `reference_generation` (media type: application/*+json)
  - added the non-success response with the status `410`
  - added the optional property `results/items/is_blocked` to the response with the `200` status
  - added the optional property `results/items/preview_urls` to the response with the `200` status
- **2024-08-26** `00000cbae4c7`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/gettyimages/apis/getty-images-api/docs/v3/ai/image-generations/refine/post.md) - [API](https://skmtc.dev/gettyimages/apis/getty-images-api.md) - [Page](https://skmtc.dev/gettyimages/apis/getty-images-api/changes/v3/ai/image-generations/refine/post)