Skip to main content
POST
Ingest a video

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vbsk_live_...

Body

application/json

Provide either video_url or filename.

video_url
string

A public https video URL to fetch. Redirecting share links (Google Drive, Dropbox, S3, CDNs) are followed to the underlying file.

Maximum string length: 2048
filename
string

Ask for a presigned upload URL instead of fetching.

Maximum string length: 256
content_type
string
default:video/mp4

Response

Ingest started (VideoJob, poll poll), or an upload target was created (UploadTarget, PUT the bytes then call the ingest endpoint).

A video being ingested. Carries NO job_id. Poll poll until the video is ready, then call the endpoint you wanted again.

video_id
string
status
string
Example:

"processing"

poll
string

Path to poll, always /v1/videos/{video_id}.

next
string

What to do once the video is ready. Present on the /v1/match video_url branch; POST /v1/videos returns video_id, status and poll only.