Getty Images Color API
The Color API from Getty Images — 1 operation(s) for color.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/getty-images-color-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Getty Images Color API
version: '3'
description: '
Developer resources for the Getty Images API including SDK, documentation,
release notes, status, notifications and sample code.'
servers:
- url: https://api.gettyimages.com
description: Base URL declared by the provider in apis.yml (roadmap#122).
security:
- Api-Key: []
- OAuth2: []
tags:
- name: Color
paths:
/v3/ai/image-generations/influence-color-by-image:
post:
tags:
- Color
summary: Influence the color of generated images using a reference image
description: "# AI Generator - Influence Color By Image\n\nInfluence Color By Image allows the client application to provide an existing Getty Images creative image or an existing generated image, along with prompt text, as a reference for generating new images. The generated images are influenced by the color palette, tone and location of colors within the reference image.\n\nUse 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.\nWhen generating new images using using a `reference_asset_id`, the reference image must first be licensed (downloaded) through a traditional license product such as Premium Access.\n\n## The Influence Color By Image Request\n\nThe `InfluenceColorByImageRequest` payload requires one, and only one, reference image (`reference_asset_id`, `reference_generation`, or `reference_file_registration_id`) and accepts the following optional parameters:\n\n| Parameter | Purpose |\n| -------------------------------- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reference_asset_id` | Creative image ID of the image being used as a reference. |\n| `reference_generation` | Generation details of the image being used as a reference. |\n| `reference_file_registration_id` | Registered file id of the image being used as a reference. The `ImageReference` category **must** be used when registering the file. |\n| `prompt` _Required_ | The primary text used for the generation of the images. |\n| `negative_prompt` | Concepts to _exclude_ from the result. |\n| `noise_level`\t_Required_ | Accepted values are 0-1. Higher values will increase differences between the reference and generated images. |\n| `media_type` | Media type of the results: `photography` or `illustration` |\n| `mood` | Can be `black_and_white`, `warm`, `cool`, `natural`, `vivid`, `dramatic`, or `bold` |\n| `seed` | To create new images that have a similar aesthetic, include the seed value from a set of previously generated images. Seed can also be used to reproduce previous results. |\n| `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`). |\n| `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. |\n| `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. |\n\n## Fulfilled and Pending Results\n\nIn many cases the result of this call will be the final fulfilled result. In these cases, you will see a `HTTP 200 OK`\nresult and a payload including URLs to the result images and a `generation_request_id` value.\n\nHowever some generations may take more time than can be accommodated in the initial call. In these cases the result of\nthis call is `HTTP 202 Accepted` and the payload will only contain a `generation_request_id` value. This value must be\nretained by the client for subsequent polling of the `GET v3/ai/image-generations/{generationRequestId}` Get Images Generation endpoint.\n\n## Lifetime of Generated Images\n\nGenerated images will be retained for 6 months after generation.\n"
requestBody:
description: Request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/InfluenceColorByImageRequest'
text/json:
schema:
$ref: '#/components/schemas/InfluenceColorByImageRequest'
application/*+json:
schema:
$ref: '#/components/schemas/InfluenceColorByImageRequest'
responses:
'200':
description: Returns the result of a request to extend an image
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationsResponse'
'202':
description: Returns the request ID for a pending request to extend an image
content:
application/json:
schema:
$ref: '#/components/schemas/PendingImageGenerationResponse'
'400':
description: The request was invalid
'403':
description: Product quota exceeded
'404':
description: Image not found
'410':
description: GenerationRequestGone
'429':
description: TooManyConcurrentGenerations
components:
schemas:
ReferenceGeneration:
type: object
properties:
generation_request_id:
type:
- string
- 'null'
description: The id from a previous request to generate images.
index:
type: integer
description: The index of the image from the specific images generation.
format: int32
additionalProperties: false
ImageDataResponse:
type: object
properties:
index:
type: integer
format: int32
is_blocked:
type: boolean
preview_urls:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/PreviewUrl'
description: The preview URLs for the result
url:
type:
- string
- 'null'
additionalProperties: false
InfluenceColorByImageRequest:
type: object
properties:
reference_asset_id:
type:
- string
- 'null'
description: Asset Id to modify.
reference_generation:
$ref: '#/components/schemas/ReferenceGeneration'
reference_file_registration_id:
type:
- string
- 'null'
description: File Id to modify.
prompt:
type:
- string
- 'null'
description: This is the primary text used for refining the images.
negative_prompt:
type:
- string
- 'null'
description: Concepts to exclude from the result.
noise_level:
type:
- number
- 'null'
description: Accepted values are 0-1. Higher values will increase differences between the reference and generated images.
format: float
media_type:
$ref: '#/components/schemas/MediaType'
mood:
$ref: '#/components/schemas/Mood'
seed:
type:
- integer
- 'null'
description: The seed used for the generation
format: int32
product_id:
type:
- integer
- 'null'
description: If you have multiple Getty products, indicate which one you would like to use for this refine request
format: int32
project_code:
type:
- string
- 'null'
description: The project code to use for the request. Some products require this value.
notes:
type:
- string
- 'null'
description: The notes to use for the request. Some products require this value.
additionalProperties: false
description: Payload with all influence color by image parameters
Mood:
enum:
- black_and_white
- warm
- cool
- natural
- vivid
- dramatic
- bold
type: string
PendingImageGenerationResponse:
type: object
properties:
generation_request_id:
type:
- string
- 'null'
additionalProperties: false
AssetDetail:
type: object
properties:
id:
type:
- string
- 'null'
additionalProperties: false
PreviewUrl:
type: object
properties:
preview_size:
type:
- string
- 'null'
image_url:
type:
- string
- 'null'
width:
type: integer
format: int32
height:
type: integer
format: int32
additionalProperties: false
MediaType:
enum:
- photography
- illustration
type: string
ImageGenerationsResponse:
type: object
properties:
generation_request_id:
type:
- string
- 'null'
seed:
type:
- integer
- 'null'
format: int32
results:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/ImageDataResponse'
original_asset:
$ref: '#/components/schemas/AssetDetail'
additionalProperties: false
securitySchemes:
Api-Key:
type: apiKey
name: Api-Key
in: header
OAuth2:
type: oauth2
flows:
password:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
clientCredentials:
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}
authorizationCode:
authorizationUrl: https://api.gettyimages.com/v4/oauth2/auth
tokenUrl: https://api.gettyimages.com/v4/oauth2/token
refreshUrl: https://api.gettyimages.com/v4/oauth2/token
scopes: {}