> ## Documentation Index
> Fetch the complete documentation index at: https://opentooler.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Video transcription

> Give AI agents pay-per-use transcription for supported public media.

AI agents can call `video.transcript` to get transcript text, timestamped segments, detected language, source, and media duration for supported public YouTube and Vimeo media.

## Call with a public URL

```bash theme={null}
opentooler tools call video.transcript \
  --input '{"url":"https://www.youtube.com/watch?v=example","language":"en"}' \
  --max-price 2.00 \
  --json
```

For URL input, the CLI lazily downloads and verifies `yt-dlp`, fetches audio locally, resolves duration, checks the price, and sends the extracted audio for transcription.

## Prefer official captions

```bash theme={null}
opentooler tools call video.transcript \
  --input '{"url":"https://www.youtube.com/watch?v=example","use_official_transcript":true}' \
  --json
```

This YouTube-only path does not fall back to ASR when captions are unavailable.

## Pricing and limits

* ASR is billed per minute, with a one-minute minimum.
* Maximum duration is 120 minutes.
* Supported URL hosts are YouTube and Vimeo.
* Use `--async` for long media and query the invocation later.

<Info>
  Agents must not use OpenTooler to bypass private, DRM-protected, or
  members-only media restrictions. Respect source-platform terms.
</Info>