# Whisper Large Speech to Text

Transcribe audio and video to text with Whisper Large Speech to Text from Deepgram through one Spiral API key. Transcribes recorded audio in 100+ languages with OpenAI Whisper Large hosted by Deepgram. Returns a JSON transcript. Slower than Nova models and limited to about 20 minutes of processing per file. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Deepgram
- Category: Audio
- Runs: In the background
- Returns: json
- Tool id: `deepgram` / `whisper-large`
- Page: https://spiral.ai/tools/deepgram/whisper-large

## Pricing

$0.00624 per minute of audio, per channel. Redaction: $0.0026 per minute. Entity detection: $0.00221 per minute.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `url` (required) | URL or file |  | — | Audio file URL to transcribe |
| `extra` | JSON |  | — | Arbitrary key-value pairs that are attached to the API response for usage in downstream processing |
| `redact` | JSON |  | false | Redaction removes sensitive information from your transcripts |
| `search` | JSON |  | — | Search for terms or phrases in submitted audio |
| `diarize` | true or false |  | false | Deprecated: use `diarize_model` instead. Recognize speaker changes. Each word in the transcript will be assigned a speaker number starting at 0. |
| `replace` | JSON |  | — | Search for terms or phrases in submitted audio and replaces them |
| `encoding` | one of | linear16, flac, mulaw, amr-nb, amr-wb, opus, speex, g729 | — | Specify the expected encoding of your submitted audio |
| `keywords` | JSON |  | — | Keywords can boost or suppress specialized terminology and brands. `keywords` is not supported with Nova-3 models; use `keyterm` instead. |
| `language` | one of | af, am, ar, as, az, ba, be, bg, bn, bo, br, bs, ca, cs, cy, da, de, el, en, en-AU, en-GB, en-IN, en-NZ, en-US, es, es-419, es-LATAM, et, eu, fa, fi, fo, fr, fr-CA, gl, gu, ha, haw, he, hi, hi-Latn, hr, ht, hu, hy, id, id-ID, is, it, ja, jw, ka, kk, km, kn, ko, la, lb, ln, lo, lt, lv, mg, mi, mk, ml, mn, mr, ms, mt, my, ne, nl, nn, no, oc, pa, pl, ps, pt, pt-BR, pt-PT, ro, ru, sa, sd, si, sk, sl, sn, so, sq, sr, su, sv, sw, ta, te, tg, th, tk, tl, tr, tt, uk, ur, uz, vi, yi, yo, zh, zh-CN, zh-TW | en | The [BCP-47 language tag](https://tools.ietf.org/html/bcp47) that hints at the primary spoken language. |
| `numerals` | true or false |  | false | Numerals converts numbers from written format to numerical format |
| `dictation` | true or false |  | false | Dictation mode for controlling formatting with dictated speech |
| `punctuate` | true or false |  | — | Add punctuation and capitalization to the transcript Left unset, smart_format adds punctuation; false turns it off even with smart_format. |
| `utt_split` | number |  | 0.8 | Seconds to wait before detecting a pause between words in submitted audio |
| `paragraphs` | true or false |  | false | Splits audio into paragraphs to improve transcript readability |
| `utterances` | true or false |  | false | Segments speech into meaningful semantic units |
| `filler_words` | true or false |  | false | Filler Words can help transcribe interruptions in your audio, like "uh" and "um" |
| `measurements` | true or false |  | false | Spoken measurements will be converted to their corresponding abbreviations |
| `multichannel` | true or false |  | false | Transcribe each audio channel independently |
| `smart_format` | true or false |  | false | Apply formatting to transcript output. When set to true, additional formatting will be applied to transcripts to improve readability |
| `diarize_model` | one of | latest, v1, v2 | — | Select and enable a specific diarization model version. |
| `detect_entities` | true or false |  | false | Identifies and extracts key entities from content in submitted audio |
| `detect_language` | JSON |  | — | Identifies the dominant language spoken in submitted audio |
| `profanity_filter` | true or false |  | false | Profanity Filter looks for recognized profanity and converts it to the nearest recognized non-profane word or removes it from the transcript completely |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "deepgram",
    "model": "whisper-large",
    "input": {
      "url": "<url>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=deepgram&model=whisper-large

## Common questions

### Whisper Large Speech to Text

**How much does Whisper Large Speech to Text cost?**

$0.00624 per minute of audio, per channel. Redaction: $0.0026 per minute. Entity detection: $0.00221 per minute. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Whisper Large Speech to Text through an API?**

Send `POST /v1/runs` with `"provider": "deepgram"`, `"model": "whisper-large"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Deepgram to use Whisper Large Speech to Text?**

No. Spiral runs it on its own Deepgram account and charges your Spiral balance.

**Can my AI agent use Whisper Large Speech to Text?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

