Video Download API | Unified Agent APIs

Overview

Download video from any URL and return a temporary download link

Credits

Video: 3, Audio: 2

Providers

Yt-dlpAWS S3

SDK Method

client.videoDownload(...)

Modes

The mode parameter is a preset that configures optimal provider routing for common use cases. You can also set individual parameters directly for fine-grained control.

Video

3 credits

Download as MP4 video.

Full video+audio merged into MP4. 5-60s depending on length.

Audio

2 credits

Extract audio only.

Audio track as MP3 or M4A. Faster, smaller file.

Parameters

urlRequired

string

URL of the video or post containing a video.

quality

select (default: 720)

Desired video quality (best available up to this resolution).

360p

480p

720p

1080p

Best available

format

select (default: mp4)

Output format.

MP4 (video)

MP3 (audio only)

M4A (audio only)

Example Response

{
  "success": true,
  "data": {
    "download_url": "https://cdn.example.com/downloads/abc123.mp4?X-Amz-Signature=...",
    "expires_at": "2026-05-03T14:30:00Z",
    "filename": "Example_Video_Title.mp4",
    "filesize_mb": 22.1,
    "duration_seconds": 245,
    "quality": "720p",
    "format": "mp4",
    "title": "Example Video Title",
    "thumbnail_url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg"
  },
  "metadata": {
    "provider_used": "yt_dlp",
    "providers_tried": [
      "yt_dlp"
    ],
    "response_time_ms": 12500,
    "request_id": "req_v1d30dl"
  },
  "credits_used": 3
}

Get Started

Use this API through the O-mega platform. Create an API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Video Download

Test Video Download in the interactive playground. No setup required.

Open Playground