Authentication requires an access token passed as a Bearer token in an Authorization header:

Authorization: Bearer {access_token}

Note on S3

If your images will be pulled from a protected S3 bucket, you will need to set a bucket policy to allow Video Cloud to access the files. See Using Dynamic Ingest with S3 for details.

Capture images

During transcoding, Video Cloud can capture a snapshot from the video at the midpoint and save this as poster (video still) and thumbnail images.

The number of poster and thumbnail created by the Dynamic Ingest is one for each. You cannot create more than one poster and thumbnail renditions even if you have more than one image renditions in the profile.

For custom renditions, image capture requires that two special renditions be added to the ingest profile that you are using. The new renditions must have the following properties:

You should also set the capture-images flag in your request data to true, but this is the default value if the selected profile includes image renditions. (If there are no image renditions in the profile, the default for capture-images is false.)

Automatic resizing

When you add custom poster and/or thumbnail images via Studio or the Dynamic Ingest API, by default Video Cloud will resize these to match the image sizes defined in the default Ingest Profile for the account.

Override auto-resizing

Note: the technique below applies only to accounts on legacy ingest, not to Dynamic Delivery accounts.

If you want to override this behavior and have Video Cloud retain actual image dimensions, follow these steps: