Publish youtube_download tool and request guide
Browse files- LICENSE +21 -0
- README.md +98 -6
- app.js +75 -0
- example.json +27 -0
- index.html +20 -17
- input-schema.json +152 -0
- requirements.txt +2 -0
- style.css +1 -28
- task.json +26 -0
- tool.py +51 -0
LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
MIT License
|
| 2 |
+
|
| 3 |
+
Copyright (c) 2026 FlashData contributors
|
| 4 |
+
|
| 5 |
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
| 6 |
+
of this software and associated documentation files (the "Software"), to deal
|
| 7 |
+
in the Software without restriction, including without limitation the rights
|
| 8 |
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
| 9 |
+
copies of the Software, and to permit persons to whom the Software is
|
| 10 |
+
furnished to do so, subject to the following conditions:
|
| 11 |
+
|
| 12 |
+
The above copyright notice and this permission notice shall be included in all
|
| 13 |
+
copies or substantial portions of the Software.
|
| 14 |
+
|
| 15 |
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
| 16 |
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
| 17 |
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
| 18 |
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
| 19 |
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
| 20 |
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
| 21 |
+
SOFTWARE.
|
README.md
CHANGED
|
@@ -1,12 +1,104 @@
|
|
| 1 |
---
|
| 2 |
-
title:
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: static
|
|
|
|
| 7 |
pinned: false
|
| 8 |
license: mit
|
| 9 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
---
|
| 11 |
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: "YouTube video or audio delivery to cloud storage"
|
| 3 |
+
emoji: 🔎
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: indigo
|
| 6 |
sdk: static
|
| 7 |
+
app_file: index.html
|
| 8 |
pinned: false
|
| 9 |
license: mit
|
| 10 |
+
tags:
|
| 11 |
+
- smolagents
|
| 12 |
+
- tool
|
| 13 |
+
- flashdata
|
| 14 |
+
- youtube-download
|
| 15 |
---
|
| 16 |
|
| 17 |
+
# YouTube video or audio delivery to cloud storage — FlashData
|
| 18 |
+
|
| 19 |
+
Deliver video or audio you are entitled to use into your own cloud storage for a downstream workflow. Submit once, save the job ID, and read status and the completed delivery manifest without resubmitting.
|
| 20 |
+
|
| 21 |
+
**Try this task:** Submit a short MP4 clip to configured storage, then inspect its job and file manifest.
|
| 22 |
+
|
| 23 |
+
[FlashData youtube download 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) · [Create a FlashData account](https://flashdata.dev/signup)
|
| 24 |
+
|
| 25 |
+
## Run it
|
| 26 |
+
|
| 27 |
+
Open the Space to edit a request and inspect a documentation response sample. The interactive page runs locally in your browser; it does not send a FlashData query or collect an API key. The Python tool runs in your own process.
|
| 28 |
+
|
| 29 |
+
Use Python 3.10 or newer. Install the pinned dependencies:
|
| 30 |
+
|
| 31 |
+
```sh
|
| 32 |
+
python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"
|
| 33 |
+
```
|
| 34 |
+
|
| 35 |
+
Create an API key in the FlashData console, fund the required credits, and supply the key in your local environment. Review `tool.py` before enabling remote code execution.
|
| 36 |
+
|
| 37 |
+
```python
|
| 38 |
+
import getpass
|
| 39 |
+
import os
|
| 40 |
+
from smolagents import load_tool
|
| 41 |
+
|
| 42 |
+
os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
|
| 43 |
+
os.environ["FLASHDATA_DOWNLOAD_STORAGE"] = getpass.getpass("Customer storage JSON: ")
|
| 44 |
+
tool = load_tool("flashdata-dev/youtube-cloud-media-delivery-flashdata", trust_remote_code=True)
|
| 45 |
+
result = tool(**{'operation': 'submit',
|
| 46 |
+
'parameters': {'end_at': '00:00:10',
|
| 47 |
+
'output_format': 'mp4',
|
| 48 |
+
'start_at': '00:00:00',
|
| 49 |
+
'video_id': 'FUfGcZ092b0',
|
| 50 |
+
'video_quality': '<=720'}})
|
| 51 |
+
print(result)
|
| 52 |
+
```
|
| 53 |
+
|
| 54 |
+
This is a native smolagents Tool with typed task inputs. Add the loaded tool to your own agent; model choice, prompts and model fees remain under your control. Direct calls above do not need a model.
|
| 55 |
+
|
| 56 |
+
## Inputs
|
| 57 |
+
|
| 58 |
+
| Parameter | Type | Required / default | Details |
|
| 59 |
+
| --- | --- | --- | --- |
|
| 60 |
+
| `video_id` | string | Required | 11-character YouTube video ID or a YouTube video URL. |
|
| 61 |
+
| `download_type` | string | 'audio_video' | download type enum=['audio_video', 'video', 'audio'] |
|
| 62 |
+
| `video_quality` | string | None | video quality pattern=^(best/worst/(?:<=/==/>=)(?:144/360/480/720/1080/1440/2160/4320))$ |
|
| 63 |
+
| `fps` | string | None | fps pattern=^(?:>=/<=/==)(?:[1-9]\d?/1\d\d/2[0-3]\d/240)$ |
|
| 64 |
+
| `audio_language` | string | None | audio language enum=['default', 'original'] |
|
| 65 |
+
| `audio_quality` | string | None | audio quality enum=['best', '320', '256', '192', '128'] |
|
| 66 |
+
| `yt_dlp_format` | string | None | yt dlp format |
|
| 67 |
+
| `upload_metadata` | boolean | False | upload metadata |
|
| 68 |
+
| `output_format` | string | None | output format enum=['mp4', 'webm', 'mkv', 'm4a', 'mp3', 'opus'] |
|
| 69 |
+
| `start_at` | string | None | start at pattern=^\d{1,2}:[0-5]\d:[0-5]\d$ |
|
| 70 |
+
| `end_at` | string | None | end at pattern=^\d{1,2}:[0-5]\d:[0-5]\d$ |
|
| 71 |
+
|
| 72 |
+
Optional `None` values are omitted; the documented adapter defaults apply.
|
| 73 |
+
|
| 74 |
+
Full validation rules are in `input-schema.json`.
|
| 75 |
+
|
| 76 |
+
The tool accepts `operation` (`submit`, `status`, `result`), a `parameters` object containing the above media inputs for submission, and `job_id` for reads. Storage JSON is supplied outside these tool inputs. Supported storage providers: S3, S3-compatible, OSS, GCS, Azure, COS, BOS and TOS. Follow the [storage configuration documentation](https://flashdata.dev/docs/sources/youtube_download) for provider-specific credentials.
|
| 77 |
+
|
| 78 |
+
After submission, save `result["id"]`. Then read without resubmitting:
|
| 79 |
+
|
| 80 |
+
```python
|
| 81 |
+
saved_job_id = result["id"]
|
| 82 |
+
status = tool(operation="status", job_id=saved_job_id)
|
| 83 |
+
output = tool(operation="result", job_id=saved_job_id)
|
| 84 |
+
```
|
| 85 |
+
|
| 86 |
+
In Windmill, select the same operation and job ID inputs in a later step. Pending/processing returns status. Completed output includes the JSON delivery manifest, with `file_url`, `file_size` and available media fields; the media stays in your storage.
|
| 87 |
+
|
| 88 |
+
## Output and next step
|
| 89 |
+
|
| 90 |
+
The useful data is at `links`. Relevant fields: `rel`, `href`, `method`.
|
| 91 |
+
|
| 92 |
+
Use operation=status or result with the saved job_id. A pending response is a reason to check later, not to submit another paid download. The result reader fetches JSON metadata, not the media file.
|
| 93 |
+
|
| 94 |
+
The Space includes a recorded documentation example and its original request. It is not a fresh result for the task prompt above. Optional fields may be absent.
|
| 95 |
+
|
| 96 |
+
## Costs, limits and failures
|
| 97 |
+
|
| 98 |
+
Asynchronous media download to customer storage; charged by delivered bytes, with storage charges separate. Storage credentials stay outside model-visible tool inputs. Use only media you have rights to process.
|
| 99 |
+
|
| 100 |
+
The tool is MIT licensed. It is free to install. **FlashData API calls are paid**; installation does not include free data queries. Check current [FlashData pricing](https://flashdata.dev/pricing) and your console balance. Platform, model and customer storage charges are separate. Each search/page is a separate request; Extended Search has its own rate. Downloads are charged by delivered data volume.
|
| 101 |
+
|
| 102 |
+
An uncertain timeout can still represent a charged request. Check Jobs in the FlashData console before trying again; this integration does not automatically retry paid submissions. A 401 means the key was rejected, 402 means insufficient credits, and 429 means a rate or quota limit.
|
| 103 |
+
|
| 104 |
+
[Get started with this FlashData capability](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)
|
app.js
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
const byId = id => document.getElementById(id);
|
| 2 |
+
const pythonLiteral = value => {
|
| 3 |
+
if (value === null) return 'None';
|
| 4 |
+
if (typeof value === 'boolean') return value ? 'True' : 'False';
|
| 5 |
+
if (Array.isArray(value)) return `[${value.map(pythonLiteral).join(', ')}]`;
|
| 6 |
+
if (typeof value === 'object') return `{${Object.entries(value).map(([k,v]) => `${JSON.stringify(k)}: ${pythonLiteral(v)}`).join(', ')}}`;
|
| 7 |
+
return JSON.stringify(value);
|
| 8 |
+
};
|
| 9 |
+
|
| 10 |
+
const [task, example, schema] = await Promise.all(['task.json','example.json','input-schema.json'].map(async file => {
|
| 11 |
+
const response = await fetch(file);
|
| 12 |
+
if (!response.ok) throw new Error(`Unable to load ${file}`);
|
| 13 |
+
return response.json();
|
| 14 |
+
}));
|
| 15 |
+
|
| 16 |
+
document.title = task.title;
|
| 17 |
+
for (const key of ['title','scenario','task','next','limit']) byId(key).textContent = task[key];
|
| 18 |
+
byId('docs').href = `https://flashdata.dev/docs/sources/${task.source}?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=${task.slug}`;
|
| 19 |
+
byId('source').href = `https://huggingface.co/spaces/${task.repo_id}/blob/main/tool.py`;
|
| 20 |
+
byId('readme').href = `https://huggingface.co/spaces/${task.repo_id}/blob/main/README.md`;
|
| 21 |
+
byId('parameters').value = JSON.stringify(task.input,null,2);
|
| 22 |
+
byId('response').value = JSON.stringify(example.response,null,2);
|
| 23 |
+
byId('sample-request').textContent = JSON.stringify(example.request,null,2);
|
| 24 |
+
|
| 25 |
+
function generate() {
|
| 26 |
+
try {
|
| 27 |
+
const args = JSON.parse(byId('parameters').value);
|
| 28 |
+
if (!args || Array.isArray(args) || typeof args !== 'object') throw new Error('Enter a JSON object.');
|
| 29 |
+
const allowed = task.source === 'youtube_download' ? ['operation','parameters','job_id'] : Object.keys(schema.properties);
|
| 30 |
+
if (Object.keys(args).some(key => !allowed.includes(key))) throw new Error('Use only the documented inputs; keep credentials in your local environment.');
|
| 31 |
+
const code = [
|
| 32 |
+
'# Install: python -m pip install smolagents==1.26.0 langchain-flashdata==0.2.1',
|
| 33 |
+
'import getpass', 'import os', 'from smolagents import load_tool', '',
|
| 34 |
+
'os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")',
|
| 35 |
+
...(task.source === 'youtube_download' && args.operation === 'submit' ? ['os.environ["FLASHDATA_DOWNLOAD_STORAGE"] = getpass.getpass("Customer storage JSON: ")'] : []),
|
| 36 |
+
`tool = load_tool(${JSON.stringify(task.repo_id)}, trust_remote_code=True)`,
|
| 37 |
+
`result = tool(**${pythonLiteral(args)})`, 'print(result)'
|
| 38 |
+
];
|
| 39 |
+
byId('python').textContent = code.join('\n');
|
| 40 |
+
byId('input-status').textContent = 'Python call generated. The tool validates full parameter constraints before a request.';
|
| 41 |
+
} catch (error) {
|
| 42 |
+
byId('python').textContent = '';
|
| 43 |
+
byId('input-status').textContent = error.message;
|
| 44 |
+
}
|
| 45 |
+
}
|
| 46 |
+
|
| 47 |
+
function inspect() {
|
| 48 |
+
byId('results').replaceChildren();
|
| 49 |
+
try {
|
| 50 |
+
const response = JSON.parse(byId('response').value);
|
| 51 |
+
const selected = task.path.split('.').reduce((value, key) => value?.[key], response);
|
| 52 |
+
if (selected === undefined || selected === null) throw new Error(`No value at ${task.path}. Check the response format; failed or pending requests may have different fields.`);
|
| 53 |
+
const rows = Array.isArray(selected) ? selected : [selected];
|
| 54 |
+
byId('response-status').textContent = `${rows.length} item(s) at ${task.path}. Showing up to 10.`;
|
| 55 |
+
for (const row of rows.slice(0,10)) {
|
| 56 |
+
const card = document.createElement('div'); card.className = 'result';
|
| 57 |
+
const fields = typeof row === 'object' && row !== null ? task.fields.filter(key => Object.hasOwn(row,key)) : [];
|
| 58 |
+
if (!fields.length) { const p=document.createElement('p'); p.className='field'; p.textContent=typeof row === 'string' ? row : JSON.stringify(row); card.append(p); }
|
| 59 |
+
for (const key of fields) {
|
| 60 |
+
const line=document.createElement('p'); line.className='field';
|
| 61 |
+
const label=document.createElement('b'); label.textContent=key+': '; line.append(label);
|
| 62 |
+
const value=row[key];
|
| 63 |
+
if (typeof value === 'string' && /^https?:\/\//.test(value)) {
|
| 64 |
+
const link=document.createElement('a'); link.href=value; link.textContent=value; link.target='_blank'; link.rel='noopener noreferrer'; line.append(link);
|
| 65 |
+
} else line.append(document.createTextNode(typeof value === 'object' ? JSON.stringify(value) : String(value)));
|
| 66 |
+
card.append(line);
|
| 67 |
+
}
|
| 68 |
+
byId('results').append(card);
|
| 69 |
+
}
|
| 70 |
+
} catch (error) { byId('response-status').textContent=error.message; }
|
| 71 |
+
}
|
| 72 |
+
|
| 73 |
+
byId('generate').addEventListener('click',generate);
|
| 74 |
+
byId('inspect').addEventListener('click',inspect);
|
| 75 |
+
generate(); inspect();
|
example.json
ADDED
|
@@ -0,0 +1,27 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"request": {
|
| 3 |
+
"source": "youtube_download",
|
| 4 |
+
"video_id": "FUfGcZ092b0"
|
| 5 |
+
},
|
| 6 |
+
"response": {
|
| 7 |
+
"id": "job_d265c693-950e-40bf-a13e-a432044d99ba",
|
| 8 |
+
"source": "youtube_download",
|
| 9 |
+
"status": "pending",
|
| 10 |
+
"usage": {
|
| 11 |
+
"credits": 0
|
| 12 |
+
},
|
| 13 |
+
"created_at": "2026-09-16T07:51:13.139Z",
|
| 14 |
+
"links": [
|
| 15 |
+
{
|
| 16 |
+
"rel": "self",
|
| 17 |
+
"href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba",
|
| 18 |
+
"method": "GET"
|
| 19 |
+
},
|
| 20 |
+
{
|
| 21 |
+
"rel": "results",
|
| 22 |
+
"href": "https://api.flashdata.dev/v2/jobs/job_d265c693-950e-40bf-a13e-a432044d99ba/results",
|
| 23 |
+
"method": "GET"
|
| 24 |
+
}
|
| 25 |
+
]
|
| 26 |
+
}
|
| 27 |
+
}
|
index.html
CHANGED
|
@@ -1,19 +1,22 @@
|
|
| 1 |
<!doctype html>
|
| 2 |
-
<html>
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
| 13 |
-
|
| 14 |
-
|
| 15 |
-
|
| 16 |
-
|
| 17 |
-
|
| 18 |
-
|
|
|
|
|
|
|
|
|
|
| 19 |
</html>
|
|
|
|
| 1 |
<!doctype html>
|
| 2 |
+
<html lang="en">
|
| 3 |
+
<head>
|
| 4 |
+
<meta charset="UTF-8">
|
| 5 |
+
<meta name="viewport" content="width=device-width,initial-scale=1">
|
| 6 |
+
<title>FlashData research tool</title>
|
| 7 |
+
<link rel="stylesheet" href="style.css">
|
| 8 |
+
</head>
|
| 9 |
+
<body>
|
| 10 |
+
<main>
|
| 11 |
+
<header><a href="https://flashdata.dev" class="brand">FLASHDATA</a><span>Research tools for AI agents</span></header>
|
| 12 |
+
<section class="intro"><p class="eyebrow">SMOLAGENTS TOOL · PYTHON</p><h1 id="title">Loading tool…</h1><p id="scenario"></p><a id="docs" class="cta">Get an API key and read the docs ↗</a></section>
|
| 13 |
+
<div class="grid">
|
| 14 |
+
<section class="panel"><h2>Build a request</h2><p id="task"></p><label for="parameters">Tool inputs (JSON)</label><textarea id="parameters" spellcheck="false"></textarea><button id="generate" type="button">Generate Python call</button><p id="input-status" role="status"></p><pre><code id="python"></code></pre><p class="hint">Run this code in your Python environment. Your API key is entered there, not on this page.</p></section>
|
| 15 |
+
<section class="panel"><h2>Inspect the response</h2><p class="hint">This is a recorded documentation sample, not a live response to the request on the left. You can paste your own response JSON to explore its fields.</p><details><summary>Original sample request</summary><pre id="sample-request"></pre></details><label for="response">Response JSON</label><textarea id="response" spellcheck="false"></textarea><button id="inspect" type="button">Inspect results</button><p id="response-status" role="status"></p><div id="results"></div></section>
|
| 16 |
+
</div>
|
| 17 |
+
<section class="panel next"><h2>Use the result</h2><p id="next"></p><h3>Limits and costs</h3><p id="limit"></p><p>The tool is free to install. <strong>FlashData API calls are paid.</strong> Platform, model and customer storage costs are separate. No API or model call is made by this page. <a href="https://flashdata.dev/pricing">Check pricing ↗</a></p><p>For an uncertain timeout, check Jobs before retrying a paid submission. Download jobs must be read with their saved ID; do not submit again while pending.</p></section>
|
| 18 |
+
<footer><a id="source">Review tool.py</a><a id="readme">Installation and input reference</a><span>MIT licensed integration · FlashData API terms apply separately</span></footer>
|
| 19 |
+
</main>
|
| 20 |
+
<script type="module" src="app.js"></script>
|
| 21 |
+
</body>
|
| 22 |
</html>
|
input-schema.json
ADDED
|
@@ -0,0 +1,152 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"additionalProperties": false,
|
| 3 |
+
"description": "Media options only. Storage credentials are injected by the application.",
|
| 4 |
+
"properties": {
|
| 5 |
+
"video_id": {
|
| 6 |
+
"description": "11-character YouTube video ID or a YouTube video URL.",
|
| 7 |
+
"title": "Video Id",
|
| 8 |
+
"type": "string"
|
| 9 |
+
},
|
| 10 |
+
"download_type": {
|
| 11 |
+
"default": "audio_video",
|
| 12 |
+
"enum": [
|
| 13 |
+
"audio_video",
|
| 14 |
+
"video",
|
| 15 |
+
"audio"
|
| 16 |
+
],
|
| 17 |
+
"title": "Download Type",
|
| 18 |
+
"type": "string"
|
| 19 |
+
},
|
| 20 |
+
"video_quality": {
|
| 21 |
+
"anyOf": [
|
| 22 |
+
{
|
| 23 |
+
"pattern": "^(best|worst|(?:<=|==|>=)(?:144|360|480|720|1080|1440|2160|4320))$",
|
| 24 |
+
"type": "string"
|
| 25 |
+
},
|
| 26 |
+
{
|
| 27 |
+
"type": "null"
|
| 28 |
+
}
|
| 29 |
+
],
|
| 30 |
+
"default": null,
|
| 31 |
+
"title": "Video Quality"
|
| 32 |
+
},
|
| 33 |
+
"fps": {
|
| 34 |
+
"anyOf": [
|
| 35 |
+
{
|
| 36 |
+
"pattern": "^(?:>=|<=|==)(?:[1-9]\\d?|1\\d\\d|2[0-3]\\d|240)$",
|
| 37 |
+
"type": "string"
|
| 38 |
+
},
|
| 39 |
+
{
|
| 40 |
+
"type": "null"
|
| 41 |
+
}
|
| 42 |
+
],
|
| 43 |
+
"default": null,
|
| 44 |
+
"title": "Fps"
|
| 45 |
+
},
|
| 46 |
+
"audio_language": {
|
| 47 |
+
"anyOf": [
|
| 48 |
+
{
|
| 49 |
+
"enum": [
|
| 50 |
+
"default",
|
| 51 |
+
"original"
|
| 52 |
+
],
|
| 53 |
+
"type": "string"
|
| 54 |
+
},
|
| 55 |
+
{
|
| 56 |
+
"type": "null"
|
| 57 |
+
}
|
| 58 |
+
],
|
| 59 |
+
"default": null,
|
| 60 |
+
"title": "Audio Language"
|
| 61 |
+
},
|
| 62 |
+
"audio_quality": {
|
| 63 |
+
"anyOf": [
|
| 64 |
+
{
|
| 65 |
+
"enum": [
|
| 66 |
+
"best",
|
| 67 |
+
"320",
|
| 68 |
+
"256",
|
| 69 |
+
"192",
|
| 70 |
+
"128"
|
| 71 |
+
],
|
| 72 |
+
"type": "string"
|
| 73 |
+
},
|
| 74 |
+
{
|
| 75 |
+
"type": "null"
|
| 76 |
+
}
|
| 77 |
+
],
|
| 78 |
+
"default": null,
|
| 79 |
+
"title": "Audio Quality"
|
| 80 |
+
},
|
| 81 |
+
"yt_dlp_format": {
|
| 82 |
+
"anyOf": [
|
| 83 |
+
{
|
| 84 |
+
"maxLength": 1024,
|
| 85 |
+
"minLength": 1,
|
| 86 |
+
"type": "string"
|
| 87 |
+
},
|
| 88 |
+
{
|
| 89 |
+
"type": "null"
|
| 90 |
+
}
|
| 91 |
+
],
|
| 92 |
+
"default": null,
|
| 93 |
+
"title": "Yt Dlp Format"
|
| 94 |
+
},
|
| 95 |
+
"upload_metadata": {
|
| 96 |
+
"default": false,
|
| 97 |
+
"title": "Upload Metadata",
|
| 98 |
+
"type": "boolean"
|
| 99 |
+
},
|
| 100 |
+
"output_format": {
|
| 101 |
+
"anyOf": [
|
| 102 |
+
{
|
| 103 |
+
"enum": [
|
| 104 |
+
"mp4",
|
| 105 |
+
"webm",
|
| 106 |
+
"mkv",
|
| 107 |
+
"m4a",
|
| 108 |
+
"mp3",
|
| 109 |
+
"opus"
|
| 110 |
+
],
|
| 111 |
+
"type": "string"
|
| 112 |
+
},
|
| 113 |
+
{
|
| 114 |
+
"type": "null"
|
| 115 |
+
}
|
| 116 |
+
],
|
| 117 |
+
"default": null,
|
| 118 |
+
"title": "Output Format"
|
| 119 |
+
},
|
| 120 |
+
"start_at": {
|
| 121 |
+
"anyOf": [
|
| 122 |
+
{
|
| 123 |
+
"pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
|
| 124 |
+
"type": "string"
|
| 125 |
+
},
|
| 126 |
+
{
|
| 127 |
+
"type": "null"
|
| 128 |
+
}
|
| 129 |
+
],
|
| 130 |
+
"default": null,
|
| 131 |
+
"title": "Start At"
|
| 132 |
+
},
|
| 133 |
+
"end_at": {
|
| 134 |
+
"anyOf": [
|
| 135 |
+
{
|
| 136 |
+
"pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
|
| 137 |
+
"type": "string"
|
| 138 |
+
},
|
| 139 |
+
{
|
| 140 |
+
"type": "null"
|
| 141 |
+
}
|
| 142 |
+
],
|
| 143 |
+
"default": null,
|
| 144 |
+
"title": "End At"
|
| 145 |
+
}
|
| 146 |
+
},
|
| 147 |
+
"required": [
|
| 148 |
+
"video_id"
|
| 149 |
+
],
|
| 150 |
+
"title": "YouTubeDownloadInput",
|
| 151 |
+
"type": "object"
|
| 152 |
+
}
|
requirements.txt
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
|
|
|
| 1 |
+
smolagents==1.26.0
|
| 2 |
+
langchain-flashdata==0.2.1
|
style.css
CHANGED
|
@@ -1,28 +1 @@
|
|
| 1 |
-
body {
|
| 2 |
-
padding: 2rem;
|
| 3 |
-
font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
|
| 4 |
-
}
|
| 5 |
-
|
| 6 |
-
h1 {
|
| 7 |
-
font-size: 16px;
|
| 8 |
-
margin-top: 0;
|
| 9 |
-
}
|
| 10 |
-
|
| 11 |
-
p {
|
| 12 |
-
color: rgb(107, 114, 128);
|
| 13 |
-
font-size: 15px;
|
| 14 |
-
margin-bottom: 10px;
|
| 15 |
-
margin-top: 5px;
|
| 16 |
-
}
|
| 17 |
-
|
| 18 |
-
.card {
|
| 19 |
-
max-width: 620px;
|
| 20 |
-
margin: 0 auto;
|
| 21 |
-
padding: 16px;
|
| 22 |
-
border: 1px solid lightgray;
|
| 23 |
-
border-radius: 16px;
|
| 24 |
-
}
|
| 25 |
-
|
| 26 |
-
.card p:last-child {
|
| 27 |
-
margin-bottom: 0;
|
| 28 |
-
}
|
|
|
|
| 1 |
+
:root{color-scheme:light;font-family:Inter,ui-sans-serif,system-ui,-apple-system,sans-serif;color:#14243b;background:#f4f7fb;font-synthesis:none}*{box-sizing:border-box}body{margin:0}main{max-width:1240px;margin:auto;padding:32px}a{color:#175bc1;text-underline-offset:3px}header{display:flex;align-items:center;gap:24px;border-bottom:1px solid #dce3ed;padding-bottom:24px;color:#64748b;font-size:14px}.brand{font-size:21px;letter-spacing:.1em;font-weight:850;text-decoration:none;color:#123364}.intro{max-width:900px;padding:52px 0 38px}.eyebrow{font-size:12px;letter-spacing:.13em;font-weight:750;color:#4977aa}h1{font-size:clamp(28px,4vw,46px);line-height:1.12;letter-spacing:-.035em;margin:18px 0}h2{font-size:22px;margin:0 0 14px}h3{font-size:17px;margin:28px 0 8px}p{line-height:1.65}.intro>p:not(.eyebrow){font-size:18px;color:#4d6077}.cta{display:inline-block;background:#164f9b;color:white;padding:12px 18px;border-radius:7px;text-decoration:none;font-weight:600;margin-top:12px}.grid{display:grid;grid-template-columns:1fr 1fr;gap:22px}.panel{background:#fff;border:1px solid #dce3ed;border-radius:12px;padding:26px;min-width:0;box-shadow:0 5px 20px #12336405}.hint{color:#61738b;font-size:13px}label{display:block;font-size:13px;font-weight:650;margin:20px 0 8px}textarea{display:block;width:100%;height:190px;resize:vertical;border:1px solid #cbd6e6;border-radius:7px;padding:13px;font:13px/1.55 ui-monospace,SFMono-Regular,monospace;color:#253c58;background:#fbfcff}button{margin-top:12px;border:1px solid #b5c9e4;border-radius:7px;background:#edf4ff;color:#164f9b;padding:10px 15px;cursor:pointer;font:600 14px inherit}button:hover{background:#dfecff}pre{white-space:pre-wrap;overflow-wrap:anywhere;background:#f4f7fb;padding:15px;border-radius:7px;font:12px/1.6 ui-monospace,SFMono-Regular,monospace}details{font-size:13px}summary{cursor:pointer;color:#175bc1}.result{padding:14px 0;border-bottom:1px solid #e5ebf3}.result:first-child{padding-top:0}.field{font-size:13px;line-height:1.6;overflow-wrap:anywhere;margin:4px 0}.field b{color:#62758b;font-weight:500}.next{margin-top:22px}footer{display:flex;flex-wrap:wrap;gap:20px;padding:25px 0;color:#718096;font-size:12px}[role=status]{font-size:13px;color:#536b88}:focus-visible{outline:3px solid #7ea9ee;outline-offset:3px}@media(max-width:800px){main{padding:20px}.grid{grid-template-columns:1fr}.intro{padding-top:30px}header{flex-wrap:wrap;gap:8px}.panel{padding:20px}h1{font-size:32px}}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
task.json
ADDED
|
@@ -0,0 +1,26 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"slug": "youtube-cloud-media-delivery-flashdata",
|
| 3 |
+
"title": "YouTube video or audio delivery to cloud storage \u2014 FlashData",
|
| 4 |
+
"scenario": "Deliver video or audio you are entitled to use into your own cloud storage for a downstream workflow. Submit once, save the job ID, and read status and the completed delivery manifest without resubmitting.",
|
| 5 |
+
"task": "Submit a short MP4 clip to configured storage, then inspect its job and file manifest.",
|
| 6 |
+
"input": {
|
| 7 |
+
"operation": "submit",
|
| 8 |
+
"parameters": {
|
| 9 |
+
"video_id": "FUfGcZ092b0",
|
| 10 |
+
"video_quality": "<=720",
|
| 11 |
+
"output_format": "mp4",
|
| 12 |
+
"start_at": "00:00:00",
|
| 13 |
+
"end_at": "00:00:10"
|
| 14 |
+
}
|
| 15 |
+
},
|
| 16 |
+
"path": "links",
|
| 17 |
+
"fields": [
|
| 18 |
+
"rel",
|
| 19 |
+
"href",
|
| 20 |
+
"method"
|
| 21 |
+
],
|
| 22 |
+
"next": "Use operation=status or result with the saved job_id. A pending response is a reason to check later, not to submit another paid download. The result reader fetches JSON metadata, not the media file.",
|
| 23 |
+
"limit": "Asynchronous media download to customer storage; charged by delivered bytes, with storage charges separate. Storage credentials stay outside model-visible tool inputs. Use only media you have rights to process.",
|
| 24 |
+
"source": "youtube_download",
|
| 25 |
+
"repo_id": "flashdata-dev/youtube-cloud-media-delivery-flashdata"
|
| 26 |
+
}
|
tool.py
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
from smolagents import Tool
|
| 2 |
+
|
| 3 |
+
|
| 4 |
+
class FlashDataTool(Tool):
|
| 5 |
+
name = 'youtube_download'
|
| 6 |
+
description = 'Deliver video or audio you are entitled to use into your own cloud storage for a downstream workflow. Submit once, save the job ID, and read status and the completed delivery manifest without resubmitting. Asynchronous media download to customer storage; charged by delivered bytes, with storage charges separate. Storage credentials stay outside model-visible tool inputs. Use only media you have rights to process. Uses paid FlashData API credits. Never automatically retry an uncertain submission; check Jobs first.'
|
| 7 |
+
inputs = {'job_id': {'description': 'Required for status/result. ID returned by a previous submit.',
|
| 8 |
+
'nullable': True,
|
| 9 |
+
'type': 'string'},
|
| 10 |
+
'operation': {'description': 'submit starts one paid download; status or result reads an existing '
|
| 11 |
+
'job without resubmitting.',
|
| 12 |
+
'type': 'string'},
|
| 13 |
+
'parameters': {'description': 'Submit only: video_id and media options from input-schema.json. '
|
| 14 |
+
'Never include storage credentials.',
|
| 15 |
+
'nullable': True,
|
| 16 |
+
'type': 'object'}}
|
| 17 |
+
output_type = 'object'
|
| 18 |
+
|
| 19 |
+
def forward(self, operation: str, parameters: dict | None = None, job_id: str | None = None) -> dict:
|
| 20 |
+
import os
|
| 21 |
+
api_key = os.environ.get('FLASHDATA_API_KEY', '')
|
| 22 |
+
storage_json = os.environ.get('FLASHDATA_DOWNLOAD_STORAGE', '')
|
| 23 |
+
|
| 24 |
+
import json
|
| 25 |
+
from urllib.parse import urlsplit
|
| 26 |
+
from langchain_flashdata import FlashDataYouTubeDownload, FlashDataDownloadJob, FlashDataDownloadResult
|
| 27 |
+
|
| 28 |
+
if operation not in ('submit', 'status', 'result'):
|
| 29 |
+
raise ValueError('operation must be submit, status or result.')
|
| 30 |
+
if operation != 'submit':
|
| 31 |
+
if parameters:
|
| 32 |
+
raise ValueError('Status/result reads take job_id only; omit parameters.')
|
| 33 |
+
reader = FlashDataDownloadJob if operation == 'status' else FlashDataDownloadResult
|
| 34 |
+
return reader(api_key=api_key).invoke({'job_id': job_id})
|
| 35 |
+
if job_id:
|
| 36 |
+
raise ValueError('Submit does not accept job_id. To read an existing job, select status or result.')
|
| 37 |
+
if not isinstance(parameters, dict):
|
| 38 |
+
raise ValueError('Submit requires a parameters object with video_id and media options.')
|
| 39 |
+
try:
|
| 40 |
+
storage = json.loads(storage_json)
|
| 41 |
+
if not isinstance(storage, dict):
|
| 42 |
+
raise ValueError()
|
| 43 |
+
endpoint = storage.get('endpoint_url')
|
| 44 |
+
if endpoint:
|
| 45 |
+
url = urlsplit(endpoint)
|
| 46 |
+
if (url.scheme != 'https' or not url.hostname or url.username or url.password
|
| 47 |
+
or url.query or url.fragment or url.port not in (None, 443)):
|
| 48 |
+
raise ValueError()
|
| 49 |
+
except (TypeError, ValueError):
|
| 50 |
+
raise ValueError('Configure valid customer storage JSON; endpoints must be HTTPS without credentials, query or fragment.') from None
|
| 51 |
+
return FlashDataYouTubeDownload(api_key=api_key, download_storage=storage_json).invoke(parameters)
|