Brightcove Image API (1.0.0)

Download OpenAPI specification:Download

The Images API allows you to resize, crop, and/or rotate an image.

Supported image formats: png, jpg, gif

Base URL: https://images.brightcovecdn.com

Custom Image transformations

Get a specific Image with the specified transformations

path Parameters
account_id
required
string

Account ID.

image-token
required
string

A generated Image Token per account to allow images transformations. Tokens must be obtained from Brightcove Support.

imageURL
required
string

image URL - must be encodeURIComponent encoded. You can use this string encoder

query Parameters
resize
string

Resize width and height in the format widthxheight (example: 300x200)

crop
string

Crop width and height in the format 200x200 - note that you can use any combination of the 3 parameters together.

rotate
string

Rotate image the specified degrees - note that you can use any combination of the 3 parameters together

fallback
boolean
Default: false

If true a black image will be returned if the requested image cannot be.

fillArea
boolean
Default: false

Keep the aspect ratio of the image filling entirely the area given by the resize parameter. Default behavior fills only one side of the same area.

rotate
boolean

Add a play button watermark

nocache
boolean
Default: false

If true, the API response will include a Cache-Control header with the value public, max-age=0. If included, this parameter must follow one of the other parameters.

Responses

Response samples

Content type
image/*
(Returns the image file)