SHshutterstock
generative

License generated images

Changed on

Registers generated image assets and licenses the registered images.

post/v2/generative/images/licenses

Request

Query parameters

subscription_idstring

Subscription ID to use to license the image

size'small' | 'medium' | 'huge' | 'custom'

Image size

Request body

Example request

{
  "images": [
    {
      "asset_id": "asset-generation-e6706351-3624-4c4b-bc67-dbe8cd7ec66b-0",
      "ai_use_acknowledgement": true,
      "metadata": {
        "customer_id": "12345"
      },
      "size": "huge",
      "subscription_id": "s12345678"
    }
  ]
}

Response

OK

messagestring required

Server-generated message about the licensing request.

Example response

{
  "data": [
    {
      "asset_id": "asset-generation-e6706351-3624-4c4b-bc67-dbe8cd7ec66b-0",
      "image_id": "4302402011",
      "download": {
        "url": "https://download.shutterstock.com/gatekeeper/[random-characters]/shutterstock_4302402011.jpg"
      },
      "allotment_charge": 1,
      "license_id": "e10278d7b73a59bdb1fd3710af40f01815"
    }
  ],
  "message": "Generated assets were licensed. Image metadata can now be retrieved with GET /images/4302402011."
}

Changes