Sign up for free

Upload video from source

api.video enables you to upload a video container file via a URL, or clone one of your existing videos.

Upload a file from a URL

Uploading a video from a video URL enables you go through the whole video upload process in only 1 step. Paste a URL that points to your video container (for example, the .mp4 file of your video) into the source field in your request:

Uploading a file from URL
curl --user *your_api_key*: \
--request POST \
--url https://ws.api.video/videos \
--header 'Content-Type: application/json' \
--data '
{
	"title": "My First Video",
	"source": "https://www.myvideourl.com/video.mp4"
}
'

Replace the link in the example above with your video container (for example, the .mp4 file of your video). If you don’t have a video URL to test this, you can use this one for example.

Clone an existing video

You can clone a video that already exists in your api.video project. Just paste your video's videoId into the source field in your request:

Cloning a video
curl --user *your_api_key*: \
--request POST \
--url https://ws.api.video/videos \
--header 'Content-Type: application/json' \
--data '
{
	"title": "My Cloned Video",
	"source": "your_video_id_here"
}
'

API response

202 - Accepted video object creation from source URL or source Video ID (for cloning)

{
  "videoId": "your_video_id_here",
  "assets": {
	  ...
		"player": "https://embed.api.video/vod/{videoId}",
	  ...  
	}
}

Watch and share your video

The easiest way to play your video is to use the api.video player URL that you received in the API response:

"player": "https://embed.api.video/vod/{videoId}"

To watch your video, just paste the link into your favorite browser. Use the same link to share your video.

Manage your video

You can do many things to manage existing videos in your api.video environment:

Was this page helpful?