Back to api.video Glossary
Ingest
Definition of ingestion
- Food: When you ingest food, you are taking food into your body by swallowing it. Your body then processes the food into energy.
- Videos: Ingestion of a video is the process of uploading the file, and processing the video for playback.
What is 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 enough formats to support universal playback (oftentimes this is h.264 - not the best compression, but the widest playback support).
Video ingest 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.