Menu
AWS Elemental MediaConvert API Reference
API Reference

Getting Started with AWS Elemental MediaConvert Using the API

Important

Unlike most AWS services, AWS Elemental MediaConvert requires that you send your requests to an endpoint that is specific to your account. Use the following steps to get going.

  1. Set up permissions:

    • Permissions that the AWS Elemental MediaConvert service can assume on your behalf. These allow access to your S3 buckets and API Gateway. For instructions, see the Set Up IAM Permissions topic of the AWS Elemental MediaConvert User Guide.

    • Your Signature Version 4 authentication for the requests you send to AWS. When you use the AWS Command Line Interface or one of the AWS SDKs, these tools automatically sign the requests for you with the access key and secret key that you specify in your client configuration.

  2. Set up S3 file locations. The service reads your input files from and saves your output files to Amazon S3 buckets. For instructions on creating these buckets, see the Create Storage for Files topic of the AWS Elemental MediaConvert User Guide.

  3. Request your account endpoint. Send a POST request with an empty body to the following endpoint, substituting in your region. Usually, this is the region where you store your input and output files. Note that this region must match the region you set up in your client configuration.

    https://mediaconvert.<region>.amazonaws.com/2017-08-29/endpoints

    For example, for the region ap-southeast-2, the endpoint is the following:

    https://mediaconvert.ap-southeast-2.amazonaws.com/2017-08-29/endpoints

    For a full list of AWS Elemental MediaConvert public endpoints, see AWS Elemental MediaConvert Regions and Endpoints.

    The service returns an endpoint similar to "https://abcd1234.mediaconvert.us-west-1.amazonaws.com", where the first eight digits after "https://" are an alphanumeric combination unique to your account and the region matches the regional endpoint that you send the request to. This is the endpoint to use for your transcoding requests.

    Important

    If you request your account endpoint programatically, only do so once in your application. Don't make a request to the public endpoint each time you make a request to AWS Elemental MediaConvert. Otherwise, you will hit the throttle maximum on the public API endpoint.

  4. Send your transcoding requests.

    Using the account endpoint you received from your POST request, send your requests to manage transcoding jobs, queues, job templates, and presets. For general information about how these resources work, see the AWS Elemental MediaConvert User Guide. For high level information about each resource, including information about each transcoding setting, see the Resources portion of this guide.

    If you use Postman to send your requests, you can optionally copy and import the preconfigured Postman Collection Files.