Create a video

To create a video, you create its container&parameters first, before adding the video file (exception - when using an existing HTTP source).

Videos are public by default. Learn about Private videos

Up to 6 responsive video streams will be created (from 240p to 4k)

Mp4 encoded versions are created at the highest quality (max 1080p) by default.

Panoramic videos are for videos recorded in 360 degrees. You can toggle this after your 360 video upload.

Searchable parameters: title, description, tags and metadata

add an URL to upload on creation

You can also create a video directly from a video hosted on a third-party server by giving its URI in source parameter:

In this case, the service will respond 202 Accepted and ingest the video asynchronously.

Track users with Dynamic Metadata

Metadata values can be a key:value where the values are predefined, but Dynamic metadata allows you to enter any value for a defined key. To defined a dynamic metadata pair use:
"metadata":[{"dynamicKey": "__dynamicKey__"}]

The double underscore on both sides of the value allows any variable to be added for a given video session. Added the the url you might have:

<iframe type="text/html" src="https://embed.api.video/vod/vi6QvU9dhYCzW3BpPvPsZUa8?metadata[classUserName]=Doug" width="960" height="320" frameborder="0" scrollling="no"></iframe>

This video session will be tagged as watched by Doug - allowing for in-depth analysis on how each viewer interacts with the videos.

We have tutorials on:

Creating and uploading videos

Uploading large videos

Using tags with videos

Private videos

Using Dynamic Metadata

Full list of tutorials that demonstrate this endpoint.

curl --location --request POST 'https://ws.api.video/videos' \ --header 'Content-Type: application/json' \ --data-raw '{ "description": "An amazing video explaining string theory.", "metadata": [ { "key": "Author", "value": "John Doe" }, { "key": "Format", "value": "Tutorial" } ], "mp4Support": true, "panoramic": false, "playerId": "pl45KFKdlddgk654dspkze", "public": false, "tags": [ "maths", "string theory", "video" ], "title": "Maths video" }'

{ "assets": { "hls": "https://cdn.api.video/stream/831a9bd9-9f50-464c-a369-8e9d914371ae/hls/manifest.m3u8", "iframe": "<iframe src=\"//embed.api.video/vi4k0jvEUuaTdRAEjQ4Jfrgz?token=831a9bd9-9f50-464c-a369-8e9d914371ae\" width=\"100%\" height=\"100%\" frameborder=\"0\" scrolling=\"no\" allowfullscreen=\"\"></iframe>", "mp4": "https://cdn.api.video/vod/vi4k0jvEUuaTdRAEjQ4Jfrgz/token/8fd70443-d9f0-45d2-b01c-12c8cfc707c9/mp4/720/source.mp4", "player": "https://embed.api.video/vi4k0jvEUuaTdRAEjQ4Jfrgz?token=831a9bd9-9f50-464c-a369-8e9d914371ae", "thumbnail": "https://cdn.api.video/stream/831a9bd9-9f50-464c-a369-8e9d914371ae/thumbnail.jpg" }, "description": "An amazing video explaining the string theory", "metadata": [ { "key": "Author", "value": "John Doe" }, { "key": "Format", "value": "Tutorial" } ], "mp4Support": true, "panoramic": false, "playerId": "pl4k0jvEUuaTdRAEjQ4Jfrgz", "public": false, "publishedAt": "4665-07-14T23:36:18.598Z", "source": { "uri": "/videos/vi4k0jvEUuaTdRAEjQ4Jfrgz/source" }, "tags": [ "maths", "string theory", "video" ], "title": "Maths video", "videoId": "vi4k0jvEUuaTdRAEjQ4Jfrgz" }

add an URL to upload on creation

Track users with Dynamic Metadata

We have tutorials on:

Request

Responses

Create a video

add an URL to upload on creation#

Track users with Dynamic Metadata#

We have tutorials on:#

Request

Responses

add an URL to upload on creation

Track users with Dynamic Metadata

We have tutorials on: