Normal

large_logo_avatar.jpg

medium_logo_avatar.jpg

small_logo_avatar.jpg

thumbnail_logo_avatar.jpg

logo_avatar.jpg

api.video team

Video trends

Having a reliable way to filter videos based on specific criteria is a must for most video apps.

For example:
* An e-learning site may want to display different videos to each user, depending on their class list.
* An animal adoption center may choose to display only videos of cats to cat-lovers.
* A site that allows users to upload videos may not want those videos displayed until they get approved by an admin. 
* A fan site may have different levels of membership, where each level gets granted access to additional videos.

Generally, implementing something like this involves much work, takes lots of development time, clutters up your codebase, and can easily lead to bugs and data loss.
It is true that api.video is an API for video. However, we are also an API **for developers**! That is why we decided to include a video tagging and filtering system right into our API.

**Tags to the Rescue!**
api.video’s tagging feature allows you to add tags to each video. Tags can be applied to a video when it is initially created and updated at any point after that.

You can manage your tags using api.video’s web interface as well as directly through the API.

The web interface is useful for learning about tags and for managing them if you have a small number of videos.

If you are dealing with a large number of videos or need tags to be assigned automatically, then you should use the API. Don’t worry. It’s a piece of cake!

The easiest way to understand tags is to begin using them, so let’s get started.

Let’s begin with the web UI and then move on to the API.

**Tagging Videos (Web UI)**
Visit your video dashboard at [go.api.video](https://go.api.video). If you do not yet have an account, create one when prompted.

Once you are on your dashboard, you can see your video thumbnails with your most recent uploads first. 

My dash looks like this:


small_videodashboard.png

thumbnail_videodashboard.png

videodashboard.png

Let’s say I’m the founder and lead developer of petvids.com, the hottest new start-up out of Silicon Valley. I want to provide pet-lovers with the option of choosing whether they would rather see dog videos or cat videos.

small_videotags.png

thumbnail_videotags.png

videotags.png

Using the web UI, I can easily click on each video, select “edit video” in the “actions” section, and add the appropriate tag.

small_appropriate-video-tag.png

thumbnail_appropriate-video-tag.png

appropriate-video-tag.png

I can demonstrate that the tags are working using the web UI.

This is what I get if I filter for videos with the tag “cat”:

small_cat-video-tag.png

thumbnail_cat-video-tag.png

cat-video-tag.png

small_dog-video-tag.png

thumbnail_dog-video-tag.png

dog-video-tag.png

I think you get the basic idea. Let’s look at how to implement this in the backend of your app using our API.

**API and Additional Queries**
Using our API, you can request a list of all videos with the /videos endpoint:

and if you want to see the videos that you uploaded in “sandbox” mode:

Make sure you have authenticated and are making the request with your “auth” token in the header. More on that [here](https://api.video/blog/tutorials/authentication-tutorial/).

You can see what this request looks like in different frameworks and libraries [here](https://docs.api.video/reference/api/Videos#list-all-video-objects).

small_request-video-tag.png

thumbnail_request-video-tag.png

request-video-tag.png

You can try out this request directly from our documentation! Just be sure to authenticate first and then to copy your token into the authorization header.

**Filtering by Tags**
To filter by tags you need only add a ‘tags’ query param with a comma-separated list of values, like so:

In response, I get a list of the following videos:

medium_response-video-tag.jpg

small_response-video-tag.jpg

thumbnail_response-video-tag.jpg

response-video-tag.jpg

Take note that videos can contain additional tags that are not in the query string. In this case, each video has an additional tag of either cat or dog.

Let’s see another example.

What if I want to allow the user to choose to see only videos of brown dogs?

medium_additional-tags.jpg

small_additional-tags.jpg

thumbnail_additional-tags.jpg

additional-tags.jpg

That does the trick!

A word of caution. A video must have ALL the tags that you are filtering for to be returned to you.

thumbnail_filter-video-tag.png

filter-video-tag.png

Searching for “dog” and “cat” does not return videos with “either” tag. It returns videos with “both” tags, in this case, none. To get all videos tagged “cat” or “dog,” you need to make two separate queries.

I hope that clarifies how you can set and update tags using our web UI and how to filter videos by tag(s) with our web UI and API.

**Setting, Updating, and Deleting Tags via the API**
Setting, updating, and deleting tags via the API is pretty straightforward.

When creating the video, you can include tags in the request body like so:

An amazing video explaining the string theory

Maths video

To update or delete tags later, use the [video update endpoint](https://docs.api.video/reference/api/Videos#update-a-video-object).

**Something to be aware of:**
If you include a tags list when updating your video, the list of the existing tags gets overwritten by the new list. If you want only to add new tags and not lose or change existing ones, you need to include the old ones in the update request. To get the current tags, use the [“Get video” endpoint](https://docs.api.video/reference/api/Videos#retrieve-a-video-object).

I hope you feel ready to get started! If you have any questions, don’t hesitate to ask our friendly community of users and experts at [community.api.video](https://community.api.video). Thanks for reading!

Video tags can make your app awesome

small_tags.png

thumbnail_tags.png

tags.png

Chapters

doug.jpg

twitter-brands.svg

Doug Twitter

Doug Sillars

Tutorials

When uploading a long video, it can be hard for your viewers to scan to the area of the video they are interested in.  Rather than chop your video into smaller segments (and breaking up the continuity of the entire video), you can use chapters to denote placeholders in your video so that your viewers can ‘skip ahead’ or ‘skip back’ to pertinent sections that they want to watch again.

As an example for this post, I’m going to share a video my daughter made for her astronomy class.  In order to show the distance from the sun to the various planets in the Solar System, she used her GPS and walked through our neighborhood placing the planets.  The distance between each planet was scaled based on the size of the sun in her model.  It is a good study of logarithmic distances:

small_chapters.png

thumbnail_chapters.png

chapters.png

**The video was 35 minutes long.**
We knew that her teacher would not watch this, so we edited the video so that all of the walking bits were 3x faster than when she was standing at each planet. It was still 13 minutes long. This seemed like a prime example of a video suited for chapters, since it was hard to know when a planet was being placed.

[Chapters](https://docs.api.video/reference/api/Chapters#upload-a-chapter)!

Chapters are markers that appear in the video timeline, and help the viewer see different sections of your video.

large_chapters.png

medium_chapters.png

In this screenshot, we can see that we are at the “Saturn” section in the video, both from the content on the screen, but also by the annotation on the playback bar. We can also guess that the next chapters are for Uranus, and the last chapter is marking Neptune. (The chapters for the closer-in planets are under the playback bar)

How do we add chapters? With api.video, we simply create a VTT file (the same format that is used for [captions](https://api.video/blog/tutorials/how-to-add-captions-to-your-videos/) with time markers and names for each chapter. In my daughters video, we only named the sections near the planets and left the time traveling space blank:

thumbnail_capture-d-ecran-2020-07-29-a-16-11-38.png

capture-d-ecran-2020-07-29-a-16-11-38.png

I ran the VTT file through a [VTT validator](https://quuz.org/webvtt/) to ensure all the formatting was correct, and then uploaded to api.video using the api command:

After the /video/ path in the URL os the videoId that the captions are associated with, and the en and the end means that they are in english. I used my access token 
[read about how to get your api.video access token](https://api.video/blog/tutorials/authentication-tutorial/), and then finally the path the to planets.vtt file on my local computer.

That’s it! Frankly, the chapter markers on the playback timeline show the logarithmic nature of the distances in the solar system almost as well as my daughter’s video.

Conclusion:

For longer videos, your viewers might be interested in skipping to different sections of the video. Providing chapter markers makes this easier for them. What are your experiences with adding or using chapters in videos? Leave us a note in our [developer community](https://community.api.video) to let us know!

Adding chapters to your videos

Authenticate

Every call made to an api.video API requires an access_token. This tutorial will walk you through the authentication steps.

> NOTE: All of the SDKs abstract out the need for authentication.

You will need your API key to obtain the access_token. You can find your API key in [your Dashboard](https://dashboard.api.video/login).

This tutorial uses the sandbox endpoint. To upload your video in production, simply replace all ```sandbox.api.video``` instances with ```ws.api.video```.

First, call the authentication endpoint and get your access token.

**Example - Curl Request**

**Example - Http Request**
```
POST /auth/api-key HTTP/1.1
Host: sandbox.api.video
Content-Type: application/json
{
	"apiKey": "your_api_key"
}
```

**Example Response:**

The response has the access token and a refresh token. The "expires_in" parameter tells you that the token is valid for 3600 seconds = 1 hour.

## Conclusion

That's all there is to it!  Grab your api_key from [your dashboard](https://dashboard.api.video/login) and give it a try. If you run into any issues, feel free to reach out on our [forum](https://community.api.video), and we'll gladly help out!

Authentication steps

small_cedric.jpeg

thumbnail_cedric.jpeg

cedric.jpeg

Cédric Montet

JavaScript

In October 2019, after many exchanges with the team, we decided to modify our internal organisation and become a “**remote-first**” company.

Why? Why switch from a classic work environment (presence at the office everyday) to full remote for some of us?

This is not new, remote work has been a growing trend for some years now.

Two reasons pushed us towards the remote life:

## 1.  Better work/life balance

We wanted to offer our collaborators the best work conditions possible. Some of us were spending 1 to 2 hours a day commuting. Financial inconvenience, frustration, stress and long hours are now swept away thanks to the flexibility of remote life. The results? More productivity, better balance, less stress, retention of the talents.

## 2.  Develop a worldwide company culture

We have adopted this change to develop our company culture internationally. [api.video](https://api.video) is particularly used by North America and Asia. Moreover, to grow our team and find specialists in their field, we are looking for the best talents wherever they are located.

![](https://cdn-images-1.medium.com/max/800/1*qk-eKuW9pllKw5RpVLaTmQ.jpeg)

How does it work practically?

We have a simple rule: we work from anywhere we want (with a very good Internet connection of course :)) but once a week (Mondays), we all meet at the office. This way we keep a human link and gather to plan the week ahead.

It requires a minimum of organisation before switching. We have tested many tools to find the ones that suit our needs.

So, which tools are we using to keep up good internal communication and follow all projects?

**Equipment:**

*   iMac or Macbook Air according to preferences
*   a comfy chair (Steelcase "Thinks” for us)

**Software:**

*   Slack is used for all daily conversations and projects follow up. The status allows to differentiate who’s in the office and who’s working from home.
*   G Suite allows to manage all the emails, agenda, documents, …
*   Notion is used as a company memory. We write processes, key information, organisation, etc, useful information for any new collaborator.
*   Aircall for the phone. Installed on all computers and after working on the phone workflow, any of us can pick up the phone.
*   Zoom.us is used for video meetings

So many tools are now available to facilitate communication!

Since the beginning, we were convinced that video is the most efficient and human way to communicate.

With Coronavirus shaking the world, organisations and institutions are suddenly changing the way they do business and communicate. The increase of requests for live streaming and VOD to overcome the closing of institutions and potential restrictions shows the importance of video.

For the organisations that did not plan for remote work and now have to adapt to new emergency initiatives to continue their growth, I would advise starting with a video conference tool such as Gotomeeting, Skype or the most efficient according to me: Zoom.us

![the api.video team](https://cdn-images-1.medium.com/max/800/1*xomuYsRe9EiKnmx0MG68_A.png)

Zoom will allow you to quickly set up video calls in real time with all your collaborators anywhere in the world, even with a weak Internet connection.

The downside is that Zoom has not been designed to stream to a bigger audience. So if you want to share information to each collaborator it won’t be possible. That’s why we developed an api.video connector for Zoom to increase the communication in real time proposed by the tool.

## 3. How to use Zoom and api.video?

*   Generate recorded version of each video conversation on Zoom.us, to see them or rewatch them
*   Allow having a bigger audience if your message gets to the entire company, even worldwide
*   Have your video conversation in an HTML5 player, allowing anyone to watch in his/her browser or mobile without installing any Zoom.us application or plugin.
*   Get the analytics in real time of your viewers to make sure your message has been spread properly.

We made it very simple to be accessible to all. On the link below you will find all the instructions to test it out!

And [a demo](https://twilight-decorous-mail.glitch.me/?class=li1udrvkK0dX0gVm9ohlcesE), our first ever [Chemistry course](https://twilight-decorous-mail.glitch.me/?class=li1udrvkK0dX0gVm9ohlcesE) :-)

![api.video + zoom.us for large video broadcasting](https://cdn-images-1.medium.com/max/800/1*txFmd7HyokGYpdiEZ8yI6Q.png)

zoom.us + api.video in action!

If there is something unclear, you can contact me directly and we can exchange cedric@api.video

* * *

[api.video](https://api.video/) can do much more and be [integrated](https://github.com/apivideo) to your current environment (app, platform, CRM, CMS, …) but this easy connector will make you operational right away!

Of course not all businesses will be able to organise remote work. But many can start implementing better communication with simple tools.

I’ll be glad to have your feedback! What’s your experience with remote work? How do you deal with the COVID-19 situation?

Start remote work with online video and Zoom.us

medium_screenshot-2020-07-24-at-14-58-06.jpg

small_screenshot-2020-07-24-at-14-58-06.jpg

thumbnail_screenshot-2020-07-24-at-14-58-06.jpg

screenshot-2020-07-24-at-14-58-06.jpg

Video upload

video create

curl

api.video can help you simplify your video hosting and [delivery](https://api.video/streaming/). As such, one of the first things you'll want to do is to upload videos and get them loaded into the service. Once you upload the video, we'll take care of transcoding the video into streams for delivery to your users.

The easiest way to upload videos into api.video is using our API, and we'll walk through the steps to use the API and get your video online in this tutorial.

## Using cURL

This tutorial uses curl and HTTP requests to authenticate your session, create a video, and then upload the video. 

This example works for smaller videos, but as your video gets larger, you will want to break the video into smaller bites (bytes?) to facilitate upload.  Here's how do to that using the [command line](https://api.video/blog/tutorials/video-upload-tutorial-large-videos/). 

### Other languages?

We have many tutorials on video upload.  Here are a few links to help you:

* [JavaScript](https://api.video/blog/tutorials/uploading-large-files-with-javascript/).
* [Python](https://api.video/blog/tutorials/upload-a-video-from-your-computer-with-the-api-video-api-python/)
* [PHP](https://api.video/blog/tutorials/helpful-php-scripts-pt-2-upload-videos-from-an-ftp-server/)

We have several [Clients](https://docs.api.video/) for additional platforms that will help you get started uploading videos quickly.

You can also check out the API reference documentation for uploading a video here: 
* [Create a video](https://docs.api.video/reference/api/Videos#create-a-video-object)
* [Upload a video](https://docs.api.video/reference/api/Videos#upload-a-video)

### Step 1
You need an access_token in order to create and upload a video.

You will need your API key to obtain the access_token. You can find your API key on [your dashboard](https://dashboard.api.video/register).

This tutorial uses the sandbox endpoint. To upload your video in production, simply replace all ```sandbox.api.video``` instances with ```ws.api.video```.

First, call the authentication endpoint and get your access token.

**Example - Curl Request**

### Step 2
We will use the create video API to create and upload the video.

The ```Authorization: Bearer``` header uses the access_token from the first step. Hint: Make sure to not remove the end ' when pasting in your token.
The ```title``` parameter is required, so you must add a name to your video.
If your video is hosted on a server, you can use ```"source":"url"``` in the JSON to add the video.
If your video is on your local machine, we'll need to do one additional step.

This example also includes the video description.
The response contains links to the video location, and generates a unique identifier ```videoId```.

**Curl Request**

This is a title

### Step 3: Upload the video file.

> In this step, we use the upload endpoint of the API.  You can also use [delegated tokens](https://docs.api.video/reference/api/Videos) for the upload. The advantage of delegated tokens is that these are safe to use on a webpage (whereas your authorisation token is not), and the videos are directly uploaded to api.video.  You can learn more about using [delegated tokens](https://api.video/blog/product-updates/video-access-management-how-to-create-deliver-and-manage-private-videos-and-what/) for this same experience.

In Step 2, we saw how to link to a video already hosted. If the video is not hosted, and must be uploaded, we will call the video upload API:

When the upload is complete, a JSON response similar to that of step 2 is returned.

That's it - if you access the assets links in the response JSON - you can begin sharing the video you just created. Note: The mp4 URL is only added to the API response once the mp4 video has been encoded, which may take a few additional seconds.

## Conclusion

In this post, we learned about authentication of our account with our [api.video](https://api.video) token, creating a video container, and uploading a video into that container. Once your video is uploaded, it is ready to be shared with your audience!

If you have any questions or suggestions, please share them on our [commmunity forum](https://community.api.video/). To start building now, singup for an api.video account [here](https://dashboard.api.video/register). Thanks for reading! 

Video upload with cURL

Current events have caused the cancellation of face-to-face meetups.  I personally love attending meetups, and have been saddened by the number of cancellations that have been appearing in my inbox.

However, even with millions of us quarantined of self-isolated in our homes, we can still hold a virtual Meetup watching and sharing information.

Many Meetups already have a Slack channel for chatting, so all we need to do is add Video. Live streaming video sounds complicated , but [api.video](https://api.video) has built a video sharing portal(https://watch.a.video/broadcast) for your Meetup.  Your Live Video, and all the recorded videos are all organised on one simple page!  Just 3 simple steps, and you are ready to go with your online meetup streaming.

<a href="https://res.cloudinary.com/practicaldev/image/fetch/s--BtAcv3Ot--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_880/https://dev-to-uploads.s3.amazonaws.com/i/r42pkmh9v2lxlzqzffz6.png" class="article-body-image-wrapper"><img src="https://res.cloudinary.com/practicaldev/image/fetch/s--BtAcv3Ot--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_880/https://dev-to-uploads.s3.amazonaws.com/i/r42pkmh9v2lxlzqzffz6.png" alt="Sample Online Meetup Portal" loading="lazy"></a>


You can try out the demo at [watch.a.video/broadcast](https://watch,a,video/broadcast).  It is currently showing a stream from an empty park, but if you [create your own livestream](https://docs.api.video/reference/api/Live-Streams#create-live-stream), and copy this code from [Github](https://github.com/dougsillars/watchLivestream), you'll be be able to add your stream of your meetup in place of the park!  Sign up for a free api key at [api.video](https://api.video).


 If you have any questions, head over to our <a href="https://community.api.video">community forum</a>.

Interested in moving your meetup online?

medium_meetup.jpg

small_meetup.jpg

thumbnail_meetup.jpg

meetup.jpg

live - create

Video list

NodeJS

With thousands of teachers suddenly teaching classes remotely, many new issues arise. What if your students do not have fast enough internet to use Zoom?  Or cannot install the required software?  How do you share the video recordings?

At [api.video](https://api.video), we've built a portal that can help you quickly organise your videos in one place for your students to watch your livestreams on the web, and also watch all your previous recorded lectures.  Best of all, with our best in class video transcoding service, your lectures can be watched live on connections as slow as 500 KBPS (half of the Zoom requirement!).

medium_capture-d-ecran-2020-07-29-a-16-44-21.jpg

small_capture-d-ecran-2020-07-29-a-16-44-21.jpg

thumbnail_capture-d-ecran-2020-07-29-a-16-44-21.jpg

capture-d-ecran-2020-07-29-a-16-44-21.jpg

You can try out the Portal here with a sample [French101 portal](https://twilight-decorous-mail.glitch.me/?class=li6FBvQINNAm5CmP4HjQxWqN). At the top of the page is where a video livestream could be watched, and at the bottom are all of the recorded sessions for the class.

The API reference documentation for listing live streams and creating them is available here: 
* [List all live streams](https://docs.api.video/reference/api/Live-Streams#list-all-live-streams)
* [Create live stream](https://docs.api.video/reference/api/Live-Streams#create-live-stream)

**Build your own!**
You do not need to have any coding experience to build your own version of this site. Simply follow the [instructions](https://glitch.com/edit/#!/twilight-decorous-mail?path=README.md:1:0) on the Read Me file, and you should have a portal up and running in no time.

There's also a video walkthrough of the setup:

How are you coping with teaching remotely? Are there tools we can help you with? Join the conversation at [community.api.video](https://community.api.video). Don't forget to sign up for your free [api.video](https://api.video) account to get started in your video sharing journey.

Organize your live streams and recordings on one simple page

medium_camera-livestreaming.jpg

small_camera-livestreaming.jpg

thumbnail_camera-livestreaming.jpg

camera-livestreaming.jpg

Some videos are large, and when creating and uploading a large video to api.video, there can be transport issues, causing the upload to fail.

When uploading large videos, they must be broken into 100MB chunks to ensure delivery.  While these also may fail, the amount of time lost is minimised, and the segement can be retried.

api.video will reassemble the video segments on the server, and create streams for your users to consume.  
 
NOTE: This tutorial walks through the process of partial video uploads using curl.  The api.video [API Clients](https://docs.api.video/) handle large video uploads automatically, allowing you to skip this process. While this is a great walkthrough of what the clients and SDKs do behind the scenes, we strongly reccomend that you use them, as getting the Content-Range headers correct (in step 4) is tricky.


This tutorial uses curl and HTTP requests to authenticate your session, create a video, and then upload the video.

Another great way to split up large files is to use JavaScript and Blob.slice. We have a [second tutorial](https://api.video/blog/tutorials/uploading-large-files-with-javascript/) for that technique.

Due to limits in how HTTP handles large file uploads, there is an upload limit of 199 MiB per video segment.

However, you can still upload videos over 199 MiB, it just needs to be split into separate chunks (under 200 MiB), and each chunk uploaded separately.

This process works for videos that are less than 200 MiB as well, but has one additional step.


## Step 1

You need an access_token in order to create and upload a video.

You will need your API key to obtain the access_token.  You can find your API key on [your dashboard](https://dashboard.api.video/overview). 

This tutorial uses the sandbox endpoint. To upload your video in production, simply replace all `sandbox.api.video` instances with `ws.api.video`.

First, call the authentication endpoint and get your access token.


### Example - Curl Request

### Step 2 

1. We will use the [create](https://docs.api.video/reference/api/Videos#create-a-video-object) API to create a video container.
2. There are many parameters you can use when you create (and upload) a video, but the only required parameter is `title` (the name of your video).
3. The response contains links to the video location, and generates a unique identifier named `videoId`.

#### Curl Request

### Step 3 - Splitting the video
You have created a video container, but have not yet uploaded the video sources.  As mentioned, a video over 199 MiB must be split into smaller chunks.

#### Mac
split is a command line tool built into MacOS.  

1. The first argument is the chunk size (here 100MB)
2. The second argument is path to the source file
3. The third argument is a pattern name for the chunked files
 
This command creates 3 files:

#### Linux
You can use the split utility to split the video into smaller chunks (max 199 MiB).

1. The first argument is the chunk size (here 100MB)
2. The second argument is path to the source file
3. The third argument is a pattern name for the chunked files

This command generated 3 chunk files:

The last chunk is generally smaller than the other ones.

#### Windows
There are a number of free tools that can split a file into chunks.

### Step 4: Uploading video chunks

We will use the [source](https://docs.api.video/reference/api/Videos#post_videos-videoid-source) API to add the source files.  Note that the url also contains the `videoId` parameter obtained in the json response from step 2.

To upload by range, you must add the following header to the request:

`Content-Range: bytes <from>-<to>/<total_size>`

- `from` is the **0-indexed** start position  in the file
- `to` is the **0-indexed** end position in the file
- `total_size` is the size of the source file. It must be identical across requests.


#### CURL requests


**Request/response 1:**

And there you go. Your large video should be uploaded and ready to go. If you have any questions or suggestions, please share them on our [community forum](https://community.api.video). You can [start building](https://dashboard.api.video/register) now!

Video upload (large videos) with cURL

captions

Videos are a compelling way to share experiences with your customers. The combination of speech, sounds, images and movement allow us to share a more enriching experience.

However, on the web a video can only be autoplayed when it is muted. As a consumer with small children, this is often a blessing: the last thing I want is a website to wake up a sleeping baby. But as a developer, I want everyone to experience everything my videos have to offer, so I want to work around this issue (but of course, while still letting everyone’s babies nap!)

One solution is to add captions. Users can still engage with your video and follow along with the dialogue. Facebook finds that [videos with captions are watched 12%](https://instapage.com/blog/closed-captioning-mute-videos) longer than videos without captions (85% of Facebook videos are watched without audio). Longer video watch time increases [your search rank](https://www.3playmedia.com/2018/12/10/7-ways-video-transcripts-captions-improve-seo/), and the presence of a captions file even improves your site SEO! With all of these advantages, the accessibility improvements of your website almost come as an afterthought.

No matter the reason you choose to add captions to your videos — you are probably wondering how it is done!

## The VTT File

Closed captioning is typically done with a VTT (Video Text Track) file. They=se are text files that simply list the text that should appear over a specified period:

thumbnail_capture-d-ecran-2020-07-29-a-16-50-10.png

capture-d-ecran-2020-07-29-a-16-50-10.png

In the example above, from 15–17.9 seconds, the text “At the left we can see” will appear on the screen, followed a split second later by “at the right we can see.” It is really a pretty straightforward format. But other than manually transcribing your video, how can you create a VTT file?

Let’s walk through 2 ways:

### VTT Creator

[VTT Creator](https://www.vtt-creator.com/) is a web based tool. You simply upload your video, and as it plays the video back, it creates captions for you.

![](https://cdn-images-1.medium.com/max/800/0*0EV4F_2lV2epjlaB)

The website uploads your video and begins the analysis, and the pane on the left fills with the subtitles

![](https://cdn-images-1.medium.com/max/800/0*XTOA3ZQoSjDk3InB)

You can download the VTT, and you’re good to go!

### Google Speech to Text

Google Cloud, Azure and AWS all have a speech to text tool. I chose Google’s for this demo, but they all operate in much the same way.

Google has a helpful [QuickStart](https://cloud.google.com/speech-to-text/docs/quickstart-client-libraries#client-libraries-install-nodejs) guide to set up your Google Cloud account for Speech to Text. The first step is to use ffmpeg to strip the audio track (there is no need to upload the video track when doing audio analysis).

I used their Node.js code example with a few changes (Code available on [GitHub](https://github.com/dougsillars/subtitles)). The video I was transcribing was over 1 minute long, so I had to host it on a Google Cloud instance. Rather than using:

There is no need to transcode the video to base64 (as described in the tutorial) if it is hosted on Google Cloud. The sample code from Google writes the transcript into the console:

![](https://cdn-images-1.medium.com/max/800/0*PHDqyWCU_PCA4nR8)

This is super cool, but we want more than a transcription — we need those time stamps. The raw JSON file has an entry for each word with the start and end time for each word:

![](https://cdn-images-1.medium.com/max/800/0*jxIPZw0Mr2CFOVLA)

So I created a function that groups words, using the first word’s start time,and the end time of the last word. The length of the phrase can be varied — in the sample code it is set to 10 words. The script outputs a VTT file to the console.

### Adding Captions to your Video

### HTML5

Adding the VTT file to your video is easy. If you are using HTML5 video, you can add a track attribute pointing to the VTT file.
```html
<video autoplay muted controls>
    <source src=”myvideo.webm”>
    <source src=”myvideo.mp4">
    <track default lang=”en” kind=”captions” src=”myvideo.vtt”>
    <track lang=”es” kind=”captions” src=”muvideo-es.vtt”>
</video>
```
### Video Streaming

If you want to add captions to your [api.video](https://api.video) video, you can use the Captions API.

1.  First you must [authenticate](https://api.video/blog/tutorials/authentication-tutorial/) your session to gain an access token.
2.  Determine the videoID of the video you’d like to add the caption to. In this example, I have created captions to [Elephant’s Dream](https://orange.blender.org/) (an Open Source video project). The video ID is: vi5UNyaStzuuj0xTAGp7qtjf

(https://embed.api.video/vod/vi5UNyaStzuuj0xTAGp7qtjf)

3. Make a call to add the [caption](https://docs.api.video/reference/api/Captions#upload-a-caption). Using curl, the request looks like:
```bash
curl [https://ws.api.video/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/en-US]
(https://ws.api.video/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/en-US) -H ‘Authorization: Bearer {access\_token}’ -F file=@/path/to/google.vtt
```

And we receive a response:
```bash
{“uri”:”/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/en”,”src”:”https://cdn.api.video/vod/vi5UNyaStzuuj0xTAGp7qtjf/captions/en.vtt","srclang":"en","default":false}
```

Note that captions are off by default. This is easily resolved by patching the video, setting the default to true. Using curl, this looks like:
```bash
 curl -X PATCH [https://ws.api.video/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/en](https://ws.api.video/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/e) -H ‘Authorization: Bearer {access\_token}’ -d ‘{“default”: true}’
```

And we receive a response:
```json
{
  “uri”:”/videos/vi5UNyaStzuuj0xTAGp7qtjf/captions/en”,
  ”src”:”https://cdn.api.video/vod/vi5UNyaStzuuj0xTAGp7qtjf/captions/en.vtt",
  "srclang":"en",
  "default":true
}
```

And watching the movie: success! the captions are turned on by default. To autoplay a video with api.video, simply add #autoplay to the end of the url, and we have an autoplaying video with captions.

Now we can rest assured that our videos will likely have more traction, be watched longer, and shared more often. And, we are making our content more accessible to users who cannot hear.

### Conclusion

Video captions not only make your content accessible, but research shows videos with captions are watched longer, and shared more often. And searchable transcriptions actually increase the SEO of your site!

Often there is reluctance to add captions due to the added work, but with just a few clicks of a button, captions can be generated automatically and uploaded for immediate playback.

[Give it a try](https://dashboard.api.video/register), and share your caption successes on the [api.video community forum](https://community.api.video/).

How to add captions to your videos

medium_captions.jpg

small_captions.jpg

thumbnail_captions.jpg

captions.jpg

iOS SDK

Product updates

Swift

[api.video](https://api.video) removes the complexity from streaming video. Our simple to use APIs allow you to focus on creating your content, and leaving the video streaming details to us.

Since launching api.video, one of the most common questions we are asked is “do you have mobile SDKs?” Today, we can answer that with a “yes!”

Late last year, we announced our [Android SDK](https://github.com/apivideo/android-sdk), and today we are happy to announce the release of our [iOS SDK](https://github.com/apivideo/ios-sdk). If you have used api.video in the past, you’ll see that all of the features that are available in our APIs are now available as native iOS calls.

If you have never used api.video, imagine a simple API interface to upload, modify, and delete video streams, create custom players, add captions or chapters, and even live stream video — all from the native app. That is the power that api.video (and all of our [SDKs](https://docs.api.video/)) can give you. To get started, read the documentation on [GitHub](https://github.com/apivideo/ios-sdk), and check out the [demo application code](https://github.com/apivideo/ios-demo) (launching this week).

The quick start guide (pulled from GitHub):

## Installation

### Cocoapod

1.  Add the following entry to your Podfile:

2. Then run pod install

3. Don’t forget to import sdkApiVideo in every file you’d like to use api.video sdk

### Quick Start

### 1\. In the AppDelegate.swift instantiate a new Client


### 2\. In the didFinishLaunchingWithOptions func add the following code

*   If you want to use the production environment, use createProduction method
*   If you want to use the sandbox environment , use createSandbox method

### 3\. In your ViewController.swift file import the sdk

And that’s all there is to it!

Now you can use all your favourite api.video calls in your mobile app, simplifying the delivery of your videos with one API to apps, browsers and billions of devices around the world.

If you have questions, file an [issue](https://github.com/apivideo/ios-sdk/issues), or reach out to us on [chat](https://api.video).

api.video launches iOS SDK

medium_1595510872-iossdk-1.jpg

small_1595510872-iossdk-1.jpg

thumbnail_1595510872-iossdk-1.jpg

1595510872-iossdk-1.jpg

codec

Huge pricing update: Introducing video encoding at no cost

large_Blog_Zero Cost (2).png

medium_Blog_Zero Cost (2).png

small_Blog_Zero Cost (2).png

thumbnail_Blog_Zero Cost (2).png

Blog_Zero Cost (2).png

Modern technology has been helpful for an increasingly fast and simple method of consuming various types of video media, whether it’s a YouTube video, our favorite shows on Netflix, or even catching up with friends across the globe on Zoom. Despite the relative ease of doing anything related to video, a few complex processes take place behind the scenes, away from public view. One such process is video encoding.

Video encoding basically makes the world go around in regards to anything related to video and video content. Thanks to the technologies behind the video encoding process, it has become much easier for people and companies to share video content on the internet. But what exactly is video encoding, and what happens during the process? We’ll take a closer look at this and much more in this handy guide to video encoding.

## What is video encoding?

In a nutshell, video encoding occurs when you take raw video footage, either from a digital camera or an analog film camera, and digitally compress it to make it a more manageable file size. Video encoding happens daily in both professional and personal capacities, and many people don’t realize it.

But, without encoding, services like Netflix and YouTube would not exist – or, at least, not in the same way that it does today. Without it, we couldn’t send videos of our beloved pets to our friends and family as easily as we can today.

## Why is video encoding used?

There are a variety of reasons why video encoding is used, but all factors point to the single function of video encoding – **compression**.

This is done to ensure optimal performance and compatibility with a selected suite of software and hardware, be it for DVD/Blu-ray playback, mobile viewing, online video streaming, or general video editing. A file's video and audio information undergo transformation and compression during the encoding process, all in accordance with the requirements of the selected encoding standard.

On a professional level, the ability to compress raw video into more manageable sizes makes it easier to transmit video content such as training, promotion, presentation, and so on over the internet. 

On a personal level, video encoding makes it much easier to send videos taken from your phone directly to friends and family. Most modern-day personal devices have built-in video encoding capabilities to allow for this to happen without a second thought.

To put things in perspective, uncompressed or unencoded video can have a data rate that’s as low as 3,000 Mbps and as high as 12,000 Mbps, depending on the length and quality of the video recorded. 

**Without encoding, it would take up to days for anyone to not just transmit video, but to be able to consume it, too.**

## Differences between video encoding and video transcoding

You need to be familiar with two more [essential terms related to video encoding](https://api.video/what-is/) – transcoding and codecs.

Transcoding relates to the conversion from one digital encoding format to another. It takes the already encoded video file, decompresses it, and then alters it before re-encoding or compressing it into a different codec. Codecs are what allow encoding to occur in the first place. They are software or hardware that gives us the ability to compress video to make them more easily stored and delivered tightly.

While you may hear “encoding” and “transcoding” used interchangeably, the two terms actually mean different things. Putting it succinctly, encoding is the initial process of compressing a video from a source – such as a camera – into a codec, while transcoding takes an already encoded video file to convert it into a different codec.

## Examples of video codecs

In order to understand video encoding, you must first be familiar with two interrelated terms: [video codecs and video formats](https://api.video/blog/product-updates/every-video-format-codec-and-container-explained/). These also tend to be used interchangeably, but much like the terms encoding and transcoding, they refer to two different things.

Video formats are the type of files in which the compressed video/audio is stored. Also known as a “container”, you can tell what a video format is by looking at the file’s extension — the three to four characters that sit after a period in a file name. Here are some of the most common video formats used today:

* MP4
* FLV
* MOV
* MKV
* LXF
* MXF
* AVI
* WebM
* QT

On the other hand, **the codec is short for “Coder / Decoder” (compression / decompression)** and relates to the video compression algorithms that allow encoding to happen. Over the years, codecs have gone through multiple iterations as it coincides with the increasing sophistication and rise in the quality of filmmaking. 

If you’re a content creator, you might be aware of some of the video codecs that exist today:

- **H.264 – also known as AVC, this is the most widely-used video codec available on every platform and mobile device.**
- H.265 – also known as HEVC, stands for High-Efficiency Video Coding, and it’s slowly overtaking H.264 as the standard. This codec can compress video much more efficiently than its predecessor.
- **VP9 – is an open-source, royalty-free codec developed by Google and is considered the direct competitor of H.265. The video compression codec VP9 was created to reduce file sizes, making streaming videos simpler.**
- **AV1 – is another royalty-free, open-source codec released in 2019 by the non-profit Alliance for Open Media. It was developed to become the successor to Google’s VP9 and contend with HEVC more directly.**

## How do different technologies handle video encoding

As you may have suspected, there are a majority of ways that different technologies handle the video encoding process. Let’s take a look at the most common technologies that use video and how video encoding works on each of them:

### Video editing software

When it comes to video content creation, a majority of people will use one of two video editing software — Adobe Premiere Pro or Apple’s Final Cut Pro. Both of these video editing software handle video encoding in very similar ways: when exporting the finished video.

Depending on which device the video content is recorded on, it will already be encoded and formatted according to the settings of the device. For those using iPhones recording 1080p video at 25 frames per second (FPS), for example, the iPhone will automatically encode the video using H.264 and contain it in a .mov file format. The video editing software will “open up” the container to get to the encoded, compressed video file within so the editing process can begin.

After editing the footage is complete, it will need to be exported, which typically concerns video encoding. The edited raw media taken from a recording device such as a camera will be encoded via the codec of the person’s choosing before being put into a .mp4 container once they’ve hit “export”. As we’ve mentioned before, the most common codec used in video content creation is H.264 for HD videos, with 4K videos using H.265. 

### Websites

Different websites utilize different techniques to handle video encoding – with a majority of the major sites like YouTube, Netflix, and so on using their own technologies to handle the process. A majority of social media websites allow you to upload video files directly onto the site to share, although most of them require the files to be saved in specific containers. 

These websites will take your video file and transcode it before using their own systems and serves to re-encode it to match multiple display resolutions. This process will happen regardless of your video file's original codec and settings. Different websites have different processes, but companies that don’t have the capacity to build their own video encoding systems can use a third-party application programming interface (or API) to handle this process. These APIs act as [dedicated video encoder](https://api.video/encoding/) that allows companies to add on-demand videos to their websites more efficiently.

Using [api.video](http://api.video) as an example, all of the videos submitted to the platform will be transformed into H.264 codec in an MP4 container. This may be done using transmuxing and/or transcoding.

We expect the video bitrate to be lower than 16 Mbps for up to 1080p resolution and 50 Mbps for up to 4K resolution. We accept any bitrates, however, we will scale them down to the limits mentioned because anything above is usually challenging for most viewers’ connection to watch.

### API

The ability to generate, store, and distribute video is made possible via a video API. [api.video](http://api.video)’s solution can be tailored to suit any specific need. 

The backend process of video on demand (VOD) is exceptionally complex, even if you’re a software programmer specializing in video. It is necessary to encode, package, and typically transcode the data before sending it to any of several possible destinations. All of these things, and more, may be done with minimal fuss using api.video.

Our API basically keeps the complexities of streaming media hidden from view, so you can rapidly develop apps with as much control as you need. This saves time and effort so developers can concentrate on making the product.

## Conclusion

As you can see through this video encoding guide, a lot of work goes into making the video you watch and the video you share possible. Without video encoding compressing raw video footage, it could take days to upload and transmit video content over the internet and perhaps even longer to be able to download and enjoy them. 

The best part about encoding at api.video is that is offered at ZERO cost. You will only be charged for delivery and hosting of your videos, and the encoding will be free. Now integrate your videos in minutes with api.video or [contact us](https://api.video/contact) for more information.

A Guide to Video Encoding & Video Codecs

large_poster-3.png

medium_poster-3.png

small_poster-3.png

thumbnail_poster-3.png

poster-3.png

Erikka Innes

Encoding and transcoding are often used interchangeably but they have slightly different definitions. **Encoding is the initial process of converting raw video files into a specific digital format or codec.** It involves compressing and packaging the video data, often to reduce file size while maintaining acceptable quality. Encoding prepares the video for storage, transmission, or playback.

&nbsp;

**Transcoding, on the other hand, involves converting a video from one digital format or codec to another.** This is typically done to optimize the video for different devices or platforms, adapt to varying network conditions, or ensure compatibility with specific playback requirements. Transcoding occurs after encoding and often involves changing resolution, bitrates, or formats without altering the content itself.

## What goes on behind encoding a video?

It's easy to say that encoding is when you go from an _uncompressed source_ to a _compressed source_, but you may ask, what exactly do compressed and uncompressed sources mean?

&nbsp;

Uncompressed sources are video files that contain data that comes directly from a camera sensor vs. encoded video. In the digital space, it's SDI (Serial Digital Interface) or HDMI (High Definition Multimedia Interface). Both of them are popular standards. You'll find HDMI in places like your GoPro camera, or a mini camcorder. These days, you might also find HDMI in professional settings, but SDI is more common due to its reliability. Another example of an uncompressed source would be something analog, for instance, VHS tapes.

&nbsp;

A compressed sources, on the other hand, are video files that have undergone compression during the encoding process. Compression involves reducing the file size by removing unnecessary information or encoding the data in a more efficient format. This process results in a smaller file size, making it more manageable for storage, transmission, and playback.


## What are the types of transcoding methods?

There are three types of transcoding, depending on what you are trying to do to get a video to suit a particular browser, player, or platform:

* **Lossless-to-lossless** - This type of transcoding maintains the quality of your video across formats but allows you to take advantage of better hardware or compression algorithms. 
* **Lossless-to-lossy** - This type of transcoding will decrease your video in quality, but it will benefit you in ways such as – you will get a smaller and/or faster playing file, or a file that is compatible with the requirements of a particular platform, player, or browser.
* **Lossy-to-lossless** - Sometimes people think this means they are regaining quality. This isn't the case in this type of transcoding. If you transcode from a lossy format to a lossless format, all that it means is that you will not lose additional quality in the conversion process. You will not regain data you already lost through compression.

## Codecs for encoding and transcoding

For both encoding and transcoding, you will need to make use of codecs. A codec's job is to compress and decompress video files. It's right there in the name -  **co**mpress **dec**ompress or encode decode. So basically, codec is an algorithm that takes the video and shrinks it or changes it into a format that makes it compatible with the requirements of wherever you want the video to play. There are many codecs because there are many ways to compress a video or livestream for playback.



## What is transmuxing?

Now that you know the difference between encoding and transcoding, let's throw one more term in there - transmuxing. Transmuxing is when you change the container for a video instead of the format. It's a way of repackaging a video to make it compatible somewhere without changing what's in the file. 

&nbsp;

This process is faster than encoding or transcoding and takes less computing power because you only change the container, not the file. It's great when you need to quickly make something available, but the downside is that it doesn't handle things like making multiple video resolutions available. If you choose a container type that's incompatible with your video file, you may also cause compatibility issues, resulting in not being able to play the video.

## In closing

* **Encoding** - Encoding happens when you compress a raw data file from a video camera sensor or an analog source like a VHS tape. 
* **Transcoding** - Transcoding happens when you take an already compressed video file and change it to another format.
* **Transmuxing** - Transmuxing happens when you change the container of a video file but leave the video file untouched. 

We hope that explains the difference between encoding and transcoding clearly. 

_If you are looking for an affordable video API solution that does not burn a hole in your pocket for transcoding and encoding videos, check out our offerings on our [homepage](https://api.video/) or [sign-up for a free account here](https://dashboard.api.video/register)!_

Encoding and transcoding: what's the difference? 

Encoding and Transcoding - What's the Difference?

large_encoding-and-transcoding-whats-the-difference.jpg

medium_encoding-and-transcoding-whats-the-difference.jpg

small_encoding-and-transcoding-whats-the-difference.jpg

thumbnail_encoding-and-transcoding-whats-the-difference.jpg

encoding-and-transcoding-whats-the-difference.jpg

Once I upload my video, how quickly will it be ready to be viewed?

Our reply to this question has always been “it's really fast.”  And it is really fast. But, the dev team gave me access to the backend database, and pointed me to a few tables that might be helpful (thanks to Thomas Persohn for your patient help!)

Thus armed, I waded into a sea of data to better understand how fast our videos are encoded at api.video

## Encoding

When a video is uploaded to api.video, it is re-encoded to a HLS stream, with several different video dimensions and bitrates.  This allows api.video to deliver properly sized video to all users - no matter the device or network connection. (Read our post on [Responsive video delivery](https://api.video/blog/video-trends/responsive-video-delivery/) to learn more.)

> Summary:  All videos are encoded at 240p, 360p, 480p, 720p, 1080p and 2160p. However, the videos are only encoded up to the initial size of the video (so if the original video is 720p, there will not be 1080p or 2160p versions available). 

**FYI:** For our customers, encoding is absolutely free – we offer adaptive bitrate encoding at zero cost. 

How long does this step take? If a customer uploads a video to our service - they want to know how efficient api.video creates the content for viewing.

### Data in the study

We are constantly making adjustments to our infrastructure to speed the encoding step of our video (and that is one reason this post is dated 2H 2020 - we expect to be faster in early 2021). The last major adjustment was made in mid October, so the data presented in this study from every video uploaded to the api.video service between 15 October and 2 December 2020.

### Parameters that affect encoding

There are 2 major parameters that affect the speed of encoding a new video stream: the output dimensions and the length (duration) of the video.  

#### Dimensions

The output video dimensions have a huge impact on video creation - a 3840 × 2160 (or 4K or 2160p) video has millions more pixels than a 320x240 (240p) video, so it takes a lot longer to create.  In general, the videos exit the encoding process from smallest to largest.

#### Duration

If a video is 30 frames per second, and is 60 seconds long, there are 1800 frames to be created.  If a 30 frame per second video is an hour long 3600s), there are 108,000 frames to be created, so the longer the video - the more time for creation.

## Analysis

To better understand the encoding time, I divided the data by the size of the output video size, and looked at 2 lengths of video  - those under 5 minutes, and videos that are 45-75 minutes long (we are often asked how long a 1 hour video takes to encode).

I calculated encoding time for each bucket of video using percentiles.  

> Quick review - percentiles break the data into 100 evenly sized segments, so the 25th percentile is when 25% of the videos have been encoded. The median is the 50th percentile, and is when 50% of videos have been encoded.  We report here to the 95th percentile for video encoding.

### Short videos - under 5 minutes long

Many of the videos uploaded to api.video are short - under 5 minutes long.  These videos are generally ready to play in a few seconds:



The above chart has a lot of data, the 25, 50, 75, 90 and 95th percentile encoding times for all 6 variants of the video that api.video creates.

The median video is ready to play (at 240p) in 5.6 seconds, but a 720p version will be ready in 15s after encoding begins, and the 4K version will be ready in 37 seconds.

95% of all videos (under 5 minutes) will be playable in 32.6s, and will have 1080p versions ready in just over 2 minutes (140s).

### Long videos - 45 - 75 minutes long

Our most frequently asked question on encoding is "how long for a 1 hour video to be encoded and ready?"  Here are the numbers:


Observant viewers will see there are no 4K videos in this report. At this time, there are very few 4K streams that reach the 1 hour timeframe, and the data was quite noisy.  Hopefully, more of our 'long uploads' will add 4K support, so we can add this metric in our next update.

The median hour long video (red line) will be ready to play (at 240p) in just over 9 minutes (555s), and a 720p version will be ready about 18 minutes after encoding begins (1099s).

95% of hour long videos will have a 240p version ready in 33 minutes, and 720p in 54 (3230s).  the 1080p version will be available for 95% of videos in 108 minutes,

## Conclusion

Short videos will be ready to play - even at high resolution - in under a minute: the median 4K encoding for a short video is 37s. 

Hour long videos take longer to encode, and the median 720p video will be ready in 18 minutes.  95% of 720p videos will be ready to play in 54 minutes.

This is really fast! You can have responsive streaming video ready for your customers in just a few minutes with a simple upload!

That said, our team is working hard in the background to improve our infrastructure to make our encoding speeds even faster! 

We're really excited to have hard numbers to share with you on our encoding speeds, and we cannot wait to re-benchmark this data in 2021 to see how much faster your videos will be encoded as we improve our service.

Do you have questions about api.video or video encoding? Reach out on our [community page](https://community.api.video).


How fast does api.video encode video? 2H 2020 data

medium_gif.jpg

small_gif.jpg

thumbnail_gif.jpg

gif.jpg

Huge pricing update! Introducing video encoding at zero cost

Featured article

# api.video blog

Blog

Follow the api.video Blog to explore tutorials, video use cases, and learn about on-demand and live-streaming video updates.

Video on demand

Live streaming

Analytics

See all features

Online learning

Short-form videos

Marketplace & E-commerce

Video messaging and recording

Quick start guides

Documentation

Ecosystem catalog

Clients & SDKs

Community

Blog

Demos

Help center

Blog

Huge pricing update! Introducing video encoding at zero cost