To create a video, you create its container¶meters 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
$ curl https://ws.api.video/videos \ -H 'Authorization: Bearer {access_token} \ -d '{"title":"My video",
"description":"so many details",
"mp4Support":true
}'
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:
$ curl https://ws.api.video/videos \
-H 'Authorization: Bearer {access_token} \
-d '{"source":"http://uri/to/video.mp4", "title":"My video"}'
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:
-
Full list of tutorials that demonstrate this endpoint.