---
title: "Begin the download process"
method: PUT
path: "/v3/ai/image-generations/{generationRequestId}/images/{index}/download"
tags: ["AiGenerator"]
---

# Begin the download process

`PUT /v3/ai/image-generations/{generationRequestId}/images/{index}/download`

# AI Generator - Download Image

Download a generated image. Initiating the download process for a 4K file may incur a cost depending on the terms of your agreement.

## Download Image Request body details

The `ImageDownloadRequest` payload to be posted contains the required `size` as well as some other optional
parameters:

| Parameter              | Purpose                                                                                                                                                                                                                                                                                                                                     |
|------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `size_name` _Required_ | Must be one of the valid download sizes retrieved through the "Get Download Sizes" endpoint                                                                                                                                                                                                                                                 |
| `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. |
| `product_id`           | The product id to download against. Only required when the customer has more than one agreement.                                                                                                                                                                                                                                            |

## 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 a URL for the download.

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` with no payload. This client should then
poll `GET v3/ai/image-generations/{generationRequestId}/images/{index}/download` periodically to get the final
download.

## Path parameters

- `generationRequestId` string, required
- `index` integer, required

## Request body

- ImageDownloadRequest — Parameters for requesting an AI generation image download
  - `notes` string, nullable — The notes to use for the download request. Some products require this value.
  - `project_code` string, nullable — The project code to use for the download request. Some products require this value.
  - `size_name` string, nullable — The size name. Valid values are 1k or 4k.
  - `product_id` integer, nullable — The product id to download against. Only required when the customer has more than one agreement.

## Response `202`

Download request was successful but is pending

## Other responses

- `400` — InvalidProduct
- `403` — NotAuthorized
- `404` — GenerationRequestIdNotFound
- `409` — A download is already in progress for the given `generationRequestId` and `index`.
- `410` — GenerationRequestGone
- `429` — DailyRequestLimitExceeded

---

[API](https://skmtc.net/gettyimages/apis/getty-images-api.md) · [All operations](https://skmtc.net/gettyimages/apis/getty-images-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gettyimages/getty-images-api/revisions/d069958d92a6/schema)