File size: 4,772 Bytes
3edf47d
b4cb4da
 
 
 
 
 
 
3edf47d
b4cb4da
936d43f
 
 
 
 
3edf47d
 
b4cb4da
936d43f
b4cb4da
936d43f
a8ca054
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
 
 
936d43f
 
 
 
 
b4cb4da
936d43f
 
 
 
 
 
 
b4cb4da
936d43f
 
 
 
 
 
 
 
 
 
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
 
 
 
b4cb4da
936d43f
 
 
b4cb4da
 
 
 
 
936d43f
b4cb4da
 
 
 
 
 
 
 
 
 
 
 
 
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
b4cb4da
936d43f
a8ca054
936d43f
b4cb4da
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
---
title: "YouTube Download to Cloud Storage"
short_description: "Download video, audio or clips to your cloud storage."
emoji: "🔎"
colorFrom: "blue"
colorTo: "indigo"
sdk: "static"
app_file: "index.html"
pinned: false
license: "mit"
tags:
  - smolagents
  - tool
  - flashdata
  - youtube-download
---

# YouTube Download to Cloud Storage

Download YouTube video, audio or clips to your own S3 or other supported cloud storage. Submit a job once, then read its status and delivery manifest.

[API documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-cloud-media-delivery-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task)

Requires your own FlashData API key and paid Credits. The Python tool is free to install.

## Try the inputs

Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key.

## Run with Python

Use Python 3.10 or newer:

```sh
python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"
```

Review [tool.py](tool.py) before enabling `trust_remote_code`. Run locally with your key:

```python
import getpass
import os
from smolagents import load_tool

os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
os.environ["FLASHDATA_DOWNLOAD_STORAGE"] = getpass.getpass("Storage configuration JSON: ")
tool = load_tool("flashdata-dev/youtube-cloud-media-delivery-flashdata", trust_remote_code=True)
result = tool(**{'operation': 'submit',
 'parameters': {'end_at': '00:00:10',
                'output_format': 'mp4',
                'start_at': '00:00:00',
                'video_id': 'FUfGcZ092b0',
                'video_quality': '<=720'}})
print(result)
```

The same loaded tool can be used with smolagents. A direct Python call does not require a model.

## Track the download

Supply storage credentials through `FLASHDATA_DOWNLOAD_STORAGE`, outside the public inputs. See [storage configuration](https://flashdata.dev/docs/sources/youtube_download?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-cloud-media-delivery-flashdata) for S3, S3-compatible, OSS, GCS, Azure, COS, BOS and TOS.

After submitting, save the job ID and read it without resubmitting:

```python
saved_job_id = result["id"]
status = tool(operation="status", job_id=saved_job_id)
# After completion:
output = tool(operation="result", job_id=saved_job_id)
```

`submit` takes media `parameters`; `status` and `result` take only `job_id`. Completed output contains a delivery manifest with `file_url`, `file_size` and available media fields.

## Inputs

The table below describes fields inside the `parameters` object for `operation="submit"`.

| Parameter | Required / default | Details |
| --- | --- | --- |
| `video_id` | Required | 11-character YouTube video ID or a YouTube video URL. |
| `download_type` | 'audio_video' | download type enum=['audio_video', 'video', 'audio'] |
| `video_quality` | None | video quality |
| `fps` | None | fps |
| `audio_language` | None | audio language enum=['default', 'original'] |
| `audio_quality` | None | audio quality enum=['best', '320', '256', '192', '128'] |
| `yt_dlp_format` | None | yt dlp format |
| `upload_metadata` | False | upload metadata |
| `output_format` | None | output format enum=['mp4', 'webm', 'mkv', 'm4a', 'mp3', 'opus'] |
| `start_at` | None | start at |
| `end_at` | None | end at |

See [input-schema.json](input-schema.json) for full validation rules. Optional `None` values are omitted; adapter defaults apply.

## Output

Read `links`. Fields: `rel`, `href`, `method`. Optional fields may be absent.

[example.json](example.json) contains a recorded response and its original request, not a new result for the input shown in the Space.

## Limits and cost

Requires your own writable storage and permission for your intended use. Downloads are asynchronous and charged by delivered data volume; storage charges are separate.

Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) before running. Any model or hosting charges are separate.

For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions.