api.video
SearchCtrl K

Features

Developers

Glossary

All things video.

Full glossary

ingest

Ingestion

  1. Food: When you ingest food, you are taking food into your body by swallowing it. Your body then processes the food into energy.
  2. Videos: Ingestion of a video is the process of uploading the file, and processing the video for playback.

Video ingestion

After the video is uploaded, a video encoder will convert the uploaded file into versions that are available for playback. This step is important as not all video formats can be played on every type of device. For example, iPhone videos are often recorded in h.265 HVEC - which is not widely supported outside of Safari and Apple products. In the conversion step, the video is created in eough formats to support universal playback (oftentimes this is h.264 - not the best compression, but the widest playback support).

Ingestion at api.video

At api.video - video ingestion occurs when a video is created, and then the video file is uploaded into the video. Once the file has been uploaded, api.video converts the video into 6 HLS video streams of differing sizes and bitrates, and a h.264 mp4 video file.

When the video is being ingested, you can query the ingestion process using the video status endpoint:

"encoding":{
"playable":true
"qualities":[
{
"quality":"360p"
"status":"encoded"
}
{
"quality":"480p"
"status":"encoded"
}
{
"quality":"720p"
"status":"encoded"
}
{
"quality":"1080p"
"status":"encoding"
}
{
"quality":"2160p"
"status":"waiting"
}

You can also use the video.encoding.quality.completed webhook to understand when the video ingestion has completed for a given video at every quality it is encoded into.