The MSL Stream Provisioning API

The Media Services Live (MSL) Ingest API enables you to publish live content, and retrieves it for delivering either through Akamai or any content delivery network (CDN). These operations are targeted primarily for OTT applications, but can also be used for other live specific events. Live origin has a publishing workflow and a delivery workflow.

In the publishing workflow, you can directly push content from encoders into Live origin through the Akamai Ingest server.

In the delivery workflow, you can pull the content that was earlier published into origin through a CDN.

Akamai’s Adaptive Media Delivery (AMD) provides high quality streaming media delivery from Akamai’s globally distributed content delivery network. The solution is optimized for Adaptive Bitrate (ABR) streaming to provide a high-quality viewing experience across the broad variety of network types - fixed or mobile, at varying connection speeds. AMD is origin storage, workflow and video player agnostic.

Media Services Live Transcoding (Beta)

Akamai takes a single high-bitrate HLS stream and converts it into multiple lower bitrates of HLS output. Live Transcoding enables you to publish a single bitrate HLS stream (contribution stream) to Media Services Live and produce a multi-bitrate stream (distribution stream) for playback. You can play both the contribution stream and the distribution streams independently. The contribution stream can contain one video and one or more audio, and subtitle playlists. The single input video bitrate is used to produce one or more lower fidelity bitrates for the output distribution stream. The input audio and subtitle playlists are preserved in the output distribution stream.

Note: To successfully leverage Media Services Live transcoding, you must ingest a single bitrate stream from your encoder.

Who Should Use This API

The MSL Ingest API enables developers and architects to access and provision media streaming using customized interfaces.

To use this API, ensure that your contract includes MediaServicesLive4:::MediaServicesLive4.

The API might not work for every user, and works based on the permissions available to the logged-in user.

Getting Started

Before using the MSL Stream Provisioning API for the first time:

  • Contact your Akamai representative to enable it for your account.

  • Review the OPEN API Introduction on tools that Akamai provides.

  • Review OPEN API Provisioning to create your OPEN API access credentials and authorizations. As detailed in the OPEN API Identity Model, you then access the API using custom hostnames that looks like this:

  • Select the following when you configure the OPEN client:
    • API Group: Luna
    • API Name: Media Streaming

Note the following:

  • Currently, the API supports only Akamai HD for the Adobe® HTTP Dynamic Streaming and Apple® HTTP Live Streaming.

  • The API mirrors the functionality available in the Luna Control Center.

  • Rate Limiting: The MSL Ingest API imposes a rate limiting constraint. Exceeding that limit results in a 429 error response. Consider this especially when calling successive operations as part of a loop.

    Responses have the following headers to specify rate limit infomation:

    • X-RateLimit-Limit: The maximum number of tokens allowed.
    • X-RateLimit-Remaining The number of tokens remaining.

URL Structure

Generate BASE_URL using the Manage APIs tool in Akamai Luna Control Center

Example: https://{BASE_URL}//config-media-live/v1/msl-origin

Last modified: 9/20/2017