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

AI Generator - Generate Variations

Generate image variations from a previously-generated image.

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 beta/ai/image-generations/{generationRequestId} Get Images Generation endpoint.

Lifetime of Generated Images

Generated images will be retained for 6 months after generation.

Servers

Path parameters

Name Type Required Description
generationRequestId String Yes

The ID from a previous request to generate images

index Integer Yes

The index of the image from the specific images generation

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
project_code String No

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

notes String No

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

product_id Integer No

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

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.