# Transcribe endpoint

`POST /transcribe` submits a transcript-only audio or video job.

Requires `X-Fast-Api-Key` from an account with Pro access. Free-tier and other non-Pro API keys return `403 api_key.pro_required` before job creation.

Use `/transcribe` when the transcript is the main output. Use `/extract` with `media.transcript` when you want transcript plus other extracted audio, frames, subtitles, or metadata in the same ZIP.

## Request

```bash
curl https://api.tools.fast/extract/transcribe \
  -H "X-Fast-Api-Key: $API_KEY" \
  -F "file=@meeting.mp4" \
  -F 'options={
    "transcription": {
      "mode": "quality",
      "language": "auto",
      "includeTxt": true,
      "includePdf": true,
      "includeDocx": true,
      "includeSrt": true,
      "includeVtt": true
    }
  }'
```

## Modes

| Mode | Use when | Pricing |
| --- | --- | --- |
| `fast` | You need a quick transcript. | Lower per-minute cost. |
| `quality` | Accuracy matters more than speed. | Higher per-minute cost. |
| `meeting-intelligence` | You need speaker-aware meeting output. | Highest per-minute cost and provider availability required. |

## Output formats

Transcript-only jobs can include plain text, JSON, PDF, DOCX, Markdown, EPUB, SRT, and VTT depending on selected options.

## Provider availability

If a selected transcription mode is temporarily unavailable, the API returns `extract.audio_transcription.provider_not_configured` or a provider-specific failure code. Retry later or submit with a different mode.