Files

Understanding how file URLs work in API responses.

File URLs in API Responses

When you fetch a video (GET /videos/{id}), the response includes direct file URLs in these fields:

• video_url — Final rendered video
• thumbnail_url — Video thumbnail image
• audio_url — Voiceover audio (only present before render completes)
• image_url — Scene images (only present before render completes)

These URLs are either presigned S3 URLs (valid for 7 days) or CDN URLs if a CDN is configured. They work without authentication.

Embedding Videos

When a video is completed, use the video_url from the video response to embed:

<video src="<video_url_from_response>" controls>