GEgettyimages
AiGenerator

Retrieve history of AI generations

Changed on

AI Generator - Generation History

Get the history of AI generation requests.

get/v3/ai/generation-history

Request

  • Base URL
    https://api.gettyimages.com (the document declares no server; this is the origin it was published from)
  • Auth
    • API key in header Api-Key
    • or OAuth 2
      Authorization codehttps://authentication.gettyimages.com/oauth2/auth
      Client credentials
      Password
      Token URLhttps://authentication.gettyimages.com/oauth2/token
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

date_startstring date-time

If included, limits the results to those generation requests made on or after date_start. Both dates and datetimes are supported. Dates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. Datetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ.

date_endstring date-time

If included, limits the results to those generation requests made on or before date_end. Both dates and datetimes are supported. Dates should be submitted in ISO 8601 format YYYY-MM-DD. The time will default to 00:00:00 UTC. Datetimes should be submitted in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ.

media_type'photography' | 'illustration'

If included, limits the results to those generation requests made for the given media type.

page_sizeinteger

The page size of results. Default is 30.

pageinteger

The page number of results. Default is 1.

product_idsinteger[]

If included, limits the results to only those requests made against the indicated products.

company_generationsboolean

If true, returns the list of previously downloaded images for all users in your company. Your account must be enabled for this functionality. Contact your Getty Images account rep for more information. Default is false.

Response

Returns the history of AI generations

result_countinteger

The total count of results, ignoring paging

Changes

  • 328d929c7310Revision changes
    • info

      added the non-success response with the status

  • f751fa2a43c9Revision changes
    • warning

      added the new background_generation enum value to the // response property for the response status (media type: text/plain)

    • warning

      added the new background_generation enum value to the // response property for the response status (media type: application/json)

    • warning

      added the new background_generation enum value to the // response property for the response status (media type: text/json)

    • warning

      added the new influence_outline_by_image enum value to the // response property for the response status (media type: text/plain)

    • warning

      added the new influence_outline_by_image enum value to the // response property for the response status (media type: application/json)

    • warning

      added the new influence_outline_by_image enum value to the // response property for the response status (media type: text/json)

    • warning

      added the new object_removal enum value to the // response property for the response status (media type: text/plain)

    • warning

      added the new object_removal enum value to the // response property for the response status (media type: application/json)

    • warning

      added the new object_removal enum value to the // response property for the response status (media type: text/json)