Build with the Media API

The Media API is the operational API for media processing and delivery in MK.IO. Use it when you need to register storage, create assets, run transforms and jobs, manage live events, publish content with streaming locators, or protect playback with streaming and content key policies.

API overview

Detail	Value
Base path	/api/v1/projects/{project_name}/media/
Scope	Project
Reference	Media API reference

How the core resources connect

The Media API becomes much easier to use once you understand the sequence:

1. A storage instance tells MK.IO how to reach cloud storage.
2. An asset points to content in that storage.
3. A transform defines processing instructions.
4. A job applies the transform to the asset and creates output assets.
5. A streaming locator publishes an asset by linking it to a streaming policy.
6. A streaming endpoint provides the delivery domain for the playback paths returned by listPaths.
7. A content key policy becomes part of the chain when you need DRM or token-based key delivery.

That resource model supports both VOD and live workflows. The difference is whether the asset is created from existing stored content or continuously written by a live output.

Two live APIs

/media/liveEvents and /live/liveEvents are separate resource models. A resource created through one API is invisible to the other. Use the Live API workflow for template-based encoding and multiview.

Common workflow patterns

VOD workflow

1. Register storage.
2. Create a source asset.
3. Run a transform job.
4. Publish with a streaming locator.

Media API live event

1. Register storage.
2. Create and start a live event.
3. Create a live output to archive the stream.
4. Publish with a streaming locator.

Live API template-based workflow

1. Create a source and asset.
2. Create a config from a preset.
3. Create and start the Live API event.
4. Publish the output asset.

Protected playback

1. Publish with a DRM-capable streaming policy.
2. Create a content key policy.
3. Create a streaming locator referencing both.

Guides

Storage

Register Azure, AWS, or Google storage and manage the credentials MK.IO uses to access it.

Assets

Create assets, inspect tracks, request file access information, organize content with labels, and apply filters.

Download asset files

Retrieve one file from an asset by requesting access information, then using the returned access URL and JWT.

Playback filters

Create asset or account filters for time ranges, track selection, and startup quality, then apply them through locators.

Transforms and jobs

Define reusable processing profiles and run them against assets.

Live streaming

Create Media API live events, connect encoders, archive with live outputs, and publish live playback.

Live API walkthrough

Build a template-based Live API event. Use this workflow for multiview and reusable encoding configs.

Streaming and publishing

Create streaming endpoints, locators, and policies, then retrieve playback URLs.

Content protection

Add DRM and key-delivery configuration to published assets.

Content, sources, and destinations

Create content identifiers, ingest sources, and egress destinations for use with the Live API.

Workflow guide

Automate a VOD pipeline

Follow an end-to-end flow from source asset through transform job to published playback.