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

# Transcription needs speech-to-text

> The video has no captions and no provider was set, or speech-to-text would cost more than maxCostDollars. Codes TRANSCRIPTION_PROVIDER_REQUIRED and MAX_COST_EXCEEDED.

```json theme={null}
{
  "success": true,
  "data": {
    "jobId": "95be812f-4a2c-410a-9fcb-3ca5b445cc44",
    "status": "failed",
    "message": "This video has no captions. Add \"provider\": \"importly\" to transcribe it with AI speech-to-text — this 1-min video would cost $0.03 from your credits ($0.02/min). Or bring your own key (deepgram, openai, assemblyai) at $0.01/min.",
    "code": "TRANSCRIPTION_PROVIDER_REQUIRED",
    "quote": { "provider": "importly", "estimatedMinutes": 1, "estimatedCostDollars": 0.03 },
    "documentationUrl": "https://www.importly.io/docs/errors/transcription-provider-required"
  }
}
```

| `code` | Meaning | What to do |
| - | - | - |
| `TRANSCRIPTION_PROVIDER_REQUIRED` | The video has no captions, and the request didn't ask for speech-to-text | Retry with `"provider": "importly"` to accept the `quote` |
| `MAX_COST_EXCEEDED` | Speech-to-text would cost more than your `maxCostDollars` | Raise the cap, or skip this video |

Nothing is charged for either.

## Reasons and how to fix

### The video has no captions

Without `provider`, Importly returns the video's own captions for $0.01. When there are none, it stops and quotes the price of speech-to-text instead of charging you by surprise. Retry with `"provider": "importly"` ($0.02 per minute, \$0.03 minimum, plus the audio download), or with your own AssemblyAI, Deepgram, or OpenAI key. With the MCP server, the agent does this retry for you.

### `providerOptions` without `provider`

Setting `providerOptions` skips captions, but doesn't pick a provider. Set `provider` too.

### The cap is too low

`maxCostDollars` covers the per-minute speech-to-text charge, not the audio download. Raise it to at least the quote's `estimatedCostDollars`.

See [Transcripts](/docs/features/transcripts.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.