v1
latestOpenAPI 3.0.42026-07-1376217536.1 KBReplace the background of an existing image
AI Generator - Background Replacement
Background Replacement allows the client application to change the background of an existing Getty Images creative image or an existing generated image through the use of prompt text or color information. Four images will be generated when prompt text is submitted, while one image will be generated when color information is submitted.
Use of this endpoint is restricted to clients with an AI Generation license product and may result in the deduction of a credit depending on the terms of your license. When generating new images using a reference_asset_id, the reference image must first be licensed (downloaded) through a traditional license product such as Premium Access before the generated image can be downloaded..
The Background Replacement Request
The BackgroundReplacement Request payload requires one, and only one, reference image (reference_asset_id or reference_generation) and accepts the following optional parameters:
| Parameter | Purpose |
|---|---|
| reference_asset_id | Creative image ID of the image being used as a reference. |
| reference_generation | Generation details of the image being used as a reference. |
| prompt | The primary text used for the generation of the images. |
| negative_prompt | Concepts to exclude from the result. |
| background_color | Color information to use for the background replacement. The format is hexadecimal web colors, e.g. #0099CC. |
| media_type | Media type of the results: photography or illustration |
| negative_prompt | Concepts to exclude from the result. |
| 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). |
| 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. |
| 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. |
Request body
Response
Returns the request ID for a pending request to replace a background