# Audio & Video Transcription (Whisper) for Text and Subtitles (`cleanscrape/audio-video-transcription-whisper`) Actor

Audio and video transcription with Whisper: turn MP3, WAV, M4A, MP4 and MOV files, or another Actor's dataset, into text with timestamps and SRT and VTT subtitles. About 100 languages, with a Whisper large-v3-turbo option. No API key or login. $6 per 1,000 audio minutes. Maintained by CleanScrape.

- **URL**: https://apify.com/cleanscrape/audio-video-transcription-whisper.md
- **Developed by:** [CleanScrape](https://apify.com/cleanscrape) (community)
- **Categories:** AI, Videos, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.80 / 1,000 audio minute (fast)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Audio & Video Transcription (Whisper) for Text and Subtitles

Turn audio and video files into text. Paste direct links to MP3, M4A, WAV, FLAC, OGG, MP4, MOV, WebM or MKV files and get the full transcript with timestamps, plus TXT, SRT and VTT files for each one. It uses Whisper speech to text, works in about 100 languages and needs no API key or login.

On Fast and Accurate, Whisper runs inside the Actor on Apify: your audio is downloaded, transcribed and deleted there and is not sent to any other service. Best uses the larger Whisper large-v3-turbo model on Cloudflare Workers AI, at the price of Fast.

**Price:** $6 per 1,000 audio minutes on Fast and Best, $15 per 1,000 on Accurate. A one-hour recording is $0.36 or $0.90. No start fee. Files that fail are not charged.

### Watch the walkthrough

NASA's recruiting film becomes text and SRT subtitles in 15 seconds, and an 8.5-minute audiobook chapter is transcribed in 28 seconds with Whisper large-v3-turbo. This 83-second demo uses real runs: paste a link, compare Fast and Best, and send another Actor's results straight into it.

https://youtu.be/AcKkIthqoF8

### Start with a small run

1. The form opens with a short sample video. Keep it, or paste your own links under **Audio and video links**, one per line.
2. Choose **Fast**, **Best** or **Accurate**.
3. Click **Start**. Open **Transcripts** in the Output tab for the text, and **Transcript files** for the TXT, SRT and VTT files.

The sample is 67 seconds long. Length is rounded up to full minutes, so it costs 2 minutes: $0.012.

### Choose a ready-to-run example

Each example opens with its input filled in. Change the links and run it.

| Example | What it does |
| --- | --- |
| [Turn a video into text and SRT subtitles](https://apify.com/cleanscrape/audio-video-transcription-whisper/examples/video-to-text-and-subtitles) | A short MP4 video to text with timestamps, plus TXT, SRT and VTT files. About $0.01. |
| [Transcribe audio with Whisper large-v3-turbo](https://apify.com/cleanscrape/audio-video-transcription-whisper/examples/transcribe-audio-whisper-large-v3-turbo) | A 9-minute MP3 on Best quality, done in under a minute. About $0.05. |
| [Transcribe several audio files in one run](https://apify.com/cleanscrape/audio-video-transcription-whisper/examples/transcribe-several-audio-files) | MP3, M4A, WAV and FLAC files in one run, one row per file. About $0.05. |

### Which quality to choose

| | Fast | Best | Accurate |
| --- | --- | --- | --- |
| Model | Whisper base | Whisper large-v3-turbo | Whisper small |
| Where the audio goes | Stays on Apify | Cloudflare Workers AI, in short pieces | Stays on Apify |
| Good for | Clear speech, meetings, lectures, voice notes | Most recordings, including accents, noise and other languages | Accents, noise and names when the audio must stay on Apify |
| Time for one hour of audio | about 10 to 15 minutes | about 2 to 3 minutes | about 30 minutes |
| Price | $0.006 per audio minute | $0.006 per audio minute | $0.015 per audio minute |

Best has a daily capacity. When it is used up or Cloudflare is unavailable, files run as Fast on Apify instead, at the same price, and `model` shows `base`, or `large-v3-turbo and base` for a file that used both. On Apify's Free plan, Best covers the first 30 minutes of audio in a run and the rest runs as Fast.

Giving the **Language** skips detection and avoids a wrong guess on short or noisy files. **Names and terms to listen for** helps Whisper spell product names, people and technical words.

### Links that work

- A direct link to the file, such as `https://example.com/talk.mp4`. Links without a file ending work too when the server sends an audio or video file.
- Dropbox and Google Drive share links, when the file is shared with anyone who has the link.
- Signed links from cloud storage. Their query part is left out of anything the run shows.

Not supported: YouTube, TikTok, Instagram, Vimeo and Spotify page links (these are pages, not files), files behind a login, and podcast feeds. For podcast RSS feeds and Apple Podcasts links use [Audio Transcription and Speech to Text for Podcasts](https://apify.com/cleanscrape/podcast-transcription).

### Transcribe what another Actor found

Under **Links from another Actor**, choose a dataset: the results of a TikTok, Instagram, YouTube-style or podcast scraper, or any list of file links. The Actor finds the field that holds the file link (`audioUrl`, `videoUrl`, `mediaUrl`, `downloadUrl` and similar names first, then `url`), or reads the field you name, such as `media.downloadUrl`. Up to 200 files per run; the run message says if the dataset had more. Remove the sample link from **Audio and video links** when you use a dataset.

To transcribe every new result automatically, add this Actor as an integration on the other Actor or task: open its **Integrations** tab, choose **Audio & Video Transcription (Whisper)**, and keep the prefilled input `{"datasetId": "{{resource.defaultDatasetId}}"}`. Each finished run of the other Actor then starts a transcription of its results.

Links must lead to the file itself. Page links (a TikTok or YouTube page) are refused one by one with the reason, and are not charged.

### Use it from the API

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("cleanscrape/audio-video-transcription-whisper").call(run_input={
    "files": ["https://example.com/meeting.mp4", "https://example.com/interview.mp3"],
    "quality": "fast",
    "language": "English",
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["fileName"], row["duration"], row["wordCount"])
    print(row["srtUrl"])
```

### Input

| Field | Default | What it does |
| --- | --- | --- |
| `files` | Required unless `datasetId` is set | Direct links to audio or video files, up to 200 per run |
| `quality` | `fast` | `fast` (Whisper base), `best` (Whisper large-v3-turbo on Cloudflare) or `accurate` (Whisper small) |
| `language` | Detected | Spoken language as a name or code, such as `English`, `fi`, `Japanese` |
| `vocabulary` | None | Names and terms to listen for, separated by commas |
| `datasetId` | None | A dataset with file links, such as another Actor's results |
| `datasetField` | Found | The dataset field that holds the link, such as `videoUrl` |
| `maxMinutesPerFile` | `240` | Longer files are skipped and not charged |
| `maxFileMb` | `1024` | Larger files are skipped and not charged |

### Output

One row per file.

| Field | What it is |
| --- | --- |
| `fileName`, `fileUrl`, `fileMegabytes` | The file that was transcribed |
| `durationSeconds`, `duration` | Length of the audio |
| `language`, `languageConfidence` | The language used, and how sure the detection was (empty when you gave the language) |
| `text` | The full transcript |
| `segments` | Every spoken segment with `start` and `end` in seconds and its text |
| `wordCount` | Words in the transcript (empty for languages written without spaces) |
| `txtUrl`, `srtUrl`, `vttUrl`, `jsonUrl` | Links to the transcript as plain text, SRT subtitles, WebVTT subtitles and JSON |
| `quality`, `model` | The quality chosen and the Whisper model used |
| `minutesCharged` | Audio minutes charged for this file: its length rounded up to a full minute |
| `recordId`, `transcribedAt` | A stable ID for the file and quality, and when it was transcribed |

The run report (`REPORT`, a page you can open, and `SUMMARY`, the same as JSON) lists every link with what happened to it and why anything was skipped.

### What it can and cannot do

- Whisper writes what it hears and can mishear names, numbers and overlapping speech. Best and Accurate make fewer such mistakes than Fast; none is perfect. Check anything you will quote.
- It does not tell speakers apart. The transcript has no speaker names.
- On Fast and Accurate one language is used for a whole file, and a part in a second language comes out poorly. Best detects the language for each 90 seconds or so, so it handles recordings that switch language better.
- Music, silence and noise without speech give no transcript and are not charged.
- Video is transcribed from its sound track. Text shown on screen is not read.
- Files up to 4 GB and 10 hours can be set in the limits; a file must also fit in the run's timeout. The run says so before starting a file it cannot finish.
- On Fast and Accurate, speed depends on the run's memory: 8 GB is about twice as fast as 4 GB at the same cost per minute.

### Pricing

| Event | Price |
| --- | --- |
| Audio minute, Fast or Best | $0.006 |
| Audio minute, Accurate | $0.015 |

A file is charged for its length rounded up to a full minute, once its transcript is saved. Apify platform usage is included. Paid Apify plans get a discount (Bronze 10%, Silver 15%, Gold and higher 20%).

Examples:

- A 10-minute voice memo on Fast: $0.06.
- A 45-minute meeting recording on Fast: $0.27.
- A 2-hour lecture on Best: $0.72; on Accurate: $1.80.

Not charged: files that cannot be downloaded or opened, files with no speech, files over your limits, and files the run has no time left for.

The run stops at the **Maximum cost per run** you set, before starting a file it could not pay for, and says so.

### Common questions

#### Is my audio sent to OpenAI or another service?

Never to OpenAI. On Fast and Accurate, the Whisper model is part of the Actor and runs on Apify's servers during your run, and the audio is not sent anywhere else. On Best, the audio goes in short pieces to Cloudflare Workers AI, which runs Whisper; Cloudflare says it doesn't keep what it processes or train on it. The downloaded file and its decoded audio are deleted when the file is done.

#### Which languages work?

About 100, the languages Whisper knows. Common ones (English, Spanish, German, French, Portuguese, Japanese, Chinese and others) work well on Fast. For less common languages choose Best, or Accurate if the audio must stay on Apify, and give the language.

#### Can I get subtitles?

Yes. Every file gets an SRT and a VTT file with timestamps, linked from its row.

#### Can I export the results to Excel or CSV?

Yes. Open the Output tab and choose Export, or fetch the dataset through the API in CSV, Excel, JSON or XML.

#### Can I transcribe a file from my computer?

Put it somewhere with a link: Dropbox or Google Drive shared with anyone who has the link, or your own cloud storage. Paste that link.

#### Why was a file skipped?

The run report gives the reason for each link: not a media file, the host refused the download, longer or larger than your limits, no speech found, or not enough time left in the run.

#### Can I transcribe YouTube videos or podcasts?

Not with this Actor. It needs links to the files themselves. For podcasts use [Audio Transcription and Speech to Text for Podcasts](https://apify.com/cleanscrape/podcast-transcription).

### Support

Questions or a result that looks wrong: open an issue on the Issues tab or email contact.cleanscrape@gmail.com. Include the run ID.

If the Actor was useful, an honest review on its Store page helps other people find it.

Whisper is an open speech recognition model released by OpenAI. This Actor is an independent tool and is not affiliated with, endorsed by or sponsored by OpenAI or Cloudflare.

Maintained by CleanScrape.

### More tools from CleanScrape

- [App Store Reviews & Google Play Reviews Scraper (Play Store)](https://apify.com/cleanscrape/app-store-reviews-scraper): reviews from both app stores in one table
- [Google Trends Scraper API for Interest Over Time](https://apify.com/cleanscrape/google-trends-scraper): search interest over time, by region, related queries and trending searches
- [Map Your Show Exhibitor List Scraper for Trade Shows](https://apify.com/cleanscrape/event-exhibitor-monitor): trade show exhibitor lists and booth changes
- [Shopify Product Reviews Scraper for Judge.me and Okendo](https://apify.com/cleanscrape/shopify-reviews-scraper): Judge.me and Okendo reviews from Shopify product links
- [Google News Scraper and RSS Feed Reader](https://apify.com/cleanscrape/google-news-scraper): headlines from Google News and publisher feeds
- [Pinterest Scraper API for Pins and Pinterest Keyword Search](https://apify.com/cleanscrape/pinterest-scraper): keyword search, public pin links and board previews; search results may lack a pin link
- [Google Hotels Scraper for Google Travel Hotel Prices](https://apify.com/cleanscrape/google-hotels-scraper): hotel prices and booking offers for your dates
- [TikTok Shop Scraper API for Products, Prices and Sales](https://apify.com/cleanscrape/tiktok-shop-product-scraper): US TikTok Shop prices, sellers and ratings
- [Meta Threads Scraper for Posts and Replies](https://apify.com/cleanscrape/threads-scraper): public Threads posts from accounts or post links
- [Likee Scraper API](https://apify.com/cleanscrape/likee-scraper): Likee videos and comments
- [Flashscore Tennis Scraper for Tennis Matches and Stats](https://apify.com/cleanscrape/tennis-match-data): tennis results, statistics, point-by-point and head-to-head
- [Bilibili Scraper for Videos, Comments, Danmaku, Creators](https://apify.com/cleanscrape/bilibili-scraper): Bilibili videos, danmaku, comments and creators
- [Google Jobs Scraper for Job Search and Job Listings API](https://apify.com/cleanscrape/google-jobs-scraper): job listings with salaries and apply links
- [Whatnot Seller Tracker for Top Sellers and Sales](https://apify.com/cleanscrape/whatnot-seller-tracker): top sellers per category, items sold, sales per day and followers over time
- [Whatnot Scraper for Listings and Live Shows](https://apify.com/cleanscrape/whatnot-scraper): Whatnot listings with prices and seller stats, and live shows
- [Kick Sponsor Tracker for Streamers, Brands and Promo Codes](https://apify.com/cleanscrape/kick-sponsor-tracker): which Kick streamers promote which brands, with codes and broadcast hours
- [Casino Bonus Checker for Affiliate and Review Sites](https://apify.com/cleanscrape/casino-bonus-checker): the casino bonus each affiliate and review site shows, with promo codes, 18+ notices and affiliate IDs
- [ATP and WTA Tennis Rankings Scraper](https://apify.com/cleanscrape/tennis-rankings-scraper): current ATP and WTA singles, doubles and race rankings with points and movement
- [Career Site Job Listings from Workday, Greenhouse and Lever](https://apify.com/cleanscrape/career-site-jobs-scraper): open jobs from company career pages, with salaries and new or closed jobs per company
- [Video Frame Extractor for Scene Changes and Thumbnails](https://apify.com/cleanscrape/video-frame-extractor): still images from video files at scene changes, intervals or timestamps, with contact sheets
- [Economic Calendar Scraper for Official Release Dates](https://apify.com/cleanscrape/economic-calendar-api): central bank decisions and economic releases with dates and times
- [Audio Transcription and Speech to Text for Podcasts](https://apify.com/cleanscrape/podcast-transcription): podcast episodes and audio files to text with timestamps and subtitles
- [Google Flights Scraper and Fare Tracker](https://apify.com/cleanscrape/google-flights-scraper): flight prices by route and date, with fare tracking
- [Google Shopping Scraper and Price Tracker](https://apify.com/cleanscrape/google-shopping-scraper): product prices, stores and ratings from Google Shopping, each store’s price for a product, and price changes on a schedule
- [Telegram Channel Messages Scraper with Comments](https://apify.com/cleanscrape/telegram-channel-messages-scraper): public Telegram channel posts with views, reactions and comments
- [Google Trends Trending Now Scraper for Trending Searches](https://apify.com/cleanscrape/google-trends-trending-now): every search trending on Google now, per country, with volume and related searches
- [Telegram Channel Search and Telegram Group Search Scraper](https://apify.com/cleanscrape/telegram-channel-search-scraper): find public Telegram channels and groups by topic, with exact subscribers and latest post date
- [App Store Search and Google Play Search Scraper](https://apify.com/cleanscrape/app-store-google-play-search-scraper): apps for a keyword in the App Store and Google Play, in store order, with ratings, installs and developer contact
- [ESPN Sports Scores and Injury Reports Scraper](https://apify.com/cleanscrape/espn-sports-scores-injury-reports): sports scores, schedules and results for the NFL, NBA, MLB, NHL, college sports and soccer, plus the NFL, NBA, MLB, NHL and WNBA injury reports
- [Steam Reviews Scraper for Steam Game Reviews and Store Data](https://apify.com/cleanscrape/steam-reviews-scraper): Steam game reviews with playtime, votes, language and Steam Deck details, filtered by date or language, plus each game's review score and store data
- [Google People Also Ask Scraper with Related Searches](https://apify.com/cleanscrape/google-people-also-ask-scraper): Google People Also Ask questions with Google's AI Overview answer and top result for each, plus related searches, for any keyword and country
- [Bulk File Downloader for Images, PDFs, Video and Audio](https://apify.com/cleanscrape/bulk-file-downloader): images, PDFs, videos and audio from a list of links or from any scraper's results, with download links, sizes, SHA-256 and optional ZIP archives

# Actor input Schema

## `files` (type: `array`):

One direct link per line to an audio or video file (or choose a dataset below): MP3, M4A, WAV, FLAC, OGG, MP4, MOV, WebM, MKV and others. The link must open without logging in. For a file on your computer, share it from Dropbox or Google Drive with anyone who has the link, and paste that link. YouTube, TikTok, Instagram and Spotify page links are not supported.

## `quality` (type: `string`):

Fast suits clear speech. Best uses the larger Whisper large-v3-turbo model at the price of Fast and is the quickest; it sends the audio in short pieces to Cloudflare Workers AI. Accurate makes fewer mistakes than Fast with accents, noise and names, takes about three times as long and costs more per minute. On Fast and Accurate the audio stays on Apify.

## `language` (type: `string`):

The spoken language, as a name or code such as English, fi or Japanese. Leave empty to detect it from samples across each file. One language is used for a whole file.

## `vocabulary` (type: `string`):

Names, brands or technical words that often come up, separated by commas. This helps Whisper spell them correctly.

## `datasetId` (type: `string`):

A dataset whose rows hold audio or video file links, for example the results of a scraper run. Its links are added to the ones above (remove the sample link there), up to 200 files per run.

## `datasetField` (type: `string`):

The field that holds the file link, such as videoUrl or media.downloadUrl. Leave empty to find it: audioUrl, videoUrl, mediaUrl, downloadUrl and similar fields are tried first, then url.

## `maxMinutesPerFile` (type: `integer`):

Files longer than this are skipped and not charged.

## `maxFileMb` (type: `integer`):

Files larger than this are skipped and not charged.

## Actor input object example

```json
{
  "files": [
    "https://api.apify.com/v2/key-value-stores/YIp5ecZuBa0h3BGde/records/poem-video.mp4"
  ],
  "quality": "fast",
  "maxMinutesPerFile": 240,
  "maxFileMb": 1024
}
```

# Actor output Schema

## `transcripts` (type: `string`):

One row per file: length, language, the full text, timestamped segments and links to the transcript files.

## `files` (type: `string`):

TXT, SRT, VTT and JSON files for each transcript.

## `report` (type: `string`):

What happened to each link, and why anything was left out.

## `summary` (type: `string`):

The run as JSON, for code and AI agents.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "files": [
        "https://api.apify.com/v2/key-value-stores/YIp5ecZuBa0h3BGde/records/poem-video.mp4"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("cleanscrape/audio-video-transcription-whisper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "files": ["https://api.apify.com/v2/key-value-stores/YIp5ecZuBa0h3BGde/records/poem-video.mp4"] }

# Run the Actor and wait for it to finish
run = client.actor("cleanscrape/audio-video-transcription-whisper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "files": [
    "https://api.apify.com/v2/key-value-stores/YIp5ecZuBa0h3BGde/records/poem-video.mp4"
  ]
}' |
apify call cleanscrape/audio-video-transcription-whisper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cleanscrape/audio-video-transcription-whisper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/epEVoQtinR4dY1Pax/builds/Ju7YgvBsMdrla02fc/openapi.json
