v1

latestOpenAPI 3.0.42026-07-1376217536.1 KB

AiGenerator

Get variations on a generated image

AI Generator - Generate Variations

Generate image variations from a previously-generated image.

The Image Variation Request

The ImageVariationRequest payload to be posted contains the optional parameters:

Parameter	Purpose
product_id	If you have multiple AI Generation Getty Images products, indicate which one you would like to use for this generation request. If you have multiple products, this property is required. Can be retrieved from products (GET /v3/products).
notes	This is an optional free text parameter often used by clients who wish to include notes specific to their integration. This is for use by Getty Images customers only (not iStock). The products endpoint (GET /v3/products) provides this information.
project_code	If your Getty Images Generative AI product requires project_codes, use of this parameter is required. If your product does not require a project_code, this parameter must be excluded from the request. This is for use by Getty Images customers only (not iStock). The products endpoint (GET /v3/products) provides this information.

Fulfilled and Pending Results

In many cases the result of this call will be the final fulfilled result. In these cases, you will see a HTTP 200 OK result and a payload including URLs to the result images and a generation request id value.

However some generations may take more time than can be accommodated in the initial call. In these cases the result of this call is HTTP 202 Accepted and the payload will only contain a generation request id value. This value must be retained by the client for subsequent polling of the GET v3/ai/image-generations/{generationRequestId} Get Images Generation endpoint.

Lifetime of Generated Images

Generated images will be retained for 6 months after generation.

post/v3/ai/image-generations/{generationRequestId}/images/{index}/variations

Path parameters

generationRequestIdstring required

The ID from a previous request to generate images

indexinteger required

The index of the image from the specific images generation

Request body

product_idinteger nullable

If you have multiple Getty products, indicate which one you would like to use for this generation request

project_codestring nullable

The project code to use for the generation request. Some products require this value.

notesstring nullable

The notes to use for the generation request. Some products require this value.

Response

Returns the request ID for a pending request to generate a variation of images

generation_request_idstring nullable