File size: 3,165 Bytes
6808dcc
da9e24a
13fc636
 
 
 
 
 
6808dcc
13fc636
76df15d
 
 
 
 
6808dcc
 
da9e24a
76df15d
13fc636
76df15d
3b0211e
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
 
 
76df15d
 
 
 
 
13fc636
76df15d
 
 
 
 
 
 
 
 
 
 
 
13fc636
76df15d
 
 
13fc636
 
 
 
 
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
76df15d
13fc636
76df15d
3b0211e
76df15d
13fc636
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
---
title: "YouTube Uploader Captions"
short_description: "Uploader-provided subtitles with text and timestamps."
emoji: "🔎"
colorFrom: "blue"
colorTo: "indigo"
sdk: "static"
app_file: "index.html"
pinned: false
license: "mit"
tags:
  - smolagents
  - tool
  - flashdata
  - youtube-captions
---

# YouTube Uploader Captions

Retrieve existing uploader-provided YouTube captions by video ID and language. Get subtitle text and timestamped segments for local processing or export.

[API documentation](https://flashdata.dev/docs/sources/youtube_captions?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-uploader-captions-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_captions-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_captions-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: ")
tool = load_tool("flashdata-dev/youtube-uploader-captions-flashdata", trust_remote_code=True)
result = tool(**{'auto': False, 'language': 'en', 'video_id': 'FUfGcZ092b0'})
print(result)
```

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

## Inputs

| Parameter | Required / default | Details |
| --- | --- | --- |
| `video_id` | Required | 11-character YouTube video ID or a YouTube video URL. |
| `language` | 'en' | Requested caption language code. |
| `auto` | False | False selects manual; true automatic captions. |

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

## Output

Read `results.0.segments`. Fields: `start`, `end`, `text`. 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

Defaults to existing English manual captions. Does not generate or translate subtitles, or fall back to another track.

Each data request uses FlashData Credits. Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_captions-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.