Download Files

GET /v1/videos/:id/download

Get the URL of a stored file for a video.

Query parameters

Parameter	Type	Default	Description
type	string	video	video, source, audio, srt, vtt, or thumbnail

Type	What you get
video	The exported video, after Export
source	The original file you uploaded
audio	The combined voiceover track, if one was generated
srt	The exported subtitle file
vtt	WebVTT, generated from the subtitles on request
thumbnail	The generated thumbnail

Example

curl "https://api.vidocu.ai/v1/videos/vid_abc123/download?type=srt" \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "videoId": "vid_abc123",
  "type": "srt",
  "url": "https://storage.vidocu.ai/...",
  "exportedAt": "2026-08-09T10:31:00.000Z"
}

vtt is the exception: it returns the WebVTT text directly rather than a URL, because it's generated from the stored subtitles rather than being a stored file. That also means it works before any export, unlike srt.

Follow the url to fetch the file. It's served from a CDN, so range requests and resumable downloads work normally - which is why this returns a URL rather than streaming the bytes through the API.

info

These URLs also appear on the video object. This endpoint exists so you can ask for a file by name and get a clear reason when it isn't ready, rather than finding a null field and guessing which step you skipped.

Errors

Status	Code	Cause
400	validation_error	Unknown type
401	authentication_error	Invalid or missing API key
404	not_found	Video not found, or that file doesn't exist yet - the message says which step produces it