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

# Over your cost cap

> The job would cost more than the maxCostDollars you set, so it was turned down before downloading. Code MAX_COST_EXCEEDED.

You see this on the status endpoint (and the failure webhook) as a failed job:

```json theme={null}
{
  "success": true,
  "data": {
    "jobId": "a824760e-ece1-4415-8838-ce2a7785ea6b",
    "status": "failed",
    "message": "This import would cost about $0.42, more than your maxCostDollars of $0.05, so it wasn't downloaded. Charged $0.003 for the price check. Lower videoQuality, set includeVideo: false for audio only, or raise maxCostDollars.",
    "code": "MAX_COST_EXCEEDED",
    "documentationUrl": "https://www.importly.io/docs/errors/max-cost-exceeded"
  }
}
```

| Where | Meaning | What to do |
| - | - | - |
| [`POST /import`](/docs/endpoints/import) | The download plus any transcript would cost more than `maxCostDollars` | Ask for less, or raise the cap |
| [`POST /transcribe`](/docs/endpoints/transcribe) | Speech-to-text would cost more than `maxCostDollars` | Raise the cap, or skip this video |

An import turned down this way is charged \$0.003 for the price check; nothing is downloaded. A transcription turned down this way is free.

## Reasons and how to fix

### The import is bigger than your cap

`maxCostDollars` on an import is the most the whole request may cost: the download (\$0.002 per MB) plus the transcript if you set `includeTranscript`. Importly checks the price before it downloads anything, and `message` says what the import would cost, split into download and transcript when there's one.

In the rare case a file turns out bigger than expected, the download stops at your cap and the job fails with "This file turned out bigger than expected…". You pay for what was downloaded, never more than the cap.

To fit under the cap, ask for less: a lower `videoQuality`, `includeVideo: false` when you only need the audio, or no transcript. Or raise `maxCostDollars`. A 10-minute 720p video is about $0.15, and speech-to-text on it another $0.10.

### Importly can't price the transcript

Speech-to-text is priced per minute, so with `transcriptProvider` set Importly needs the media's length before it starts. When the source doesn't report it, the import fails rather than risk going over your cap. Drop `includeTranscript` or `maxCostDollars`, or import first and then call [`POST /transcribe`](/docs/endpoints/transcribe) with its own `maxCostDollars`.

### The transcription is longer than your cap

`maxCostDollars` on `/transcribe` covers the whole speech-to-text charge ($0.01 per minute all-in, or $0.005 with your own key). Raise it to at least the estimate in `message`.

See [Pricing & credits](/docs/billing.md).


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