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

# Troubleshooting

> Find help with uploads, API keys, queued jobs, failed processing, credits, and downloads.

Start with the problem you are seeing. Keep the exact error message and any job or media ID so you can include them if you contact support.

## Upload problems

* **A large file will not upload through the API:** use the [signed upload flow](/large-local-file-upload). It explains how to upload the file, notify ViddyScribe, and check when it is ready.
* **`upload_not_ready`:** the media is still being verified. [Check upload status](/api-reference/media/get-upload-status) before requesting generation again.
* **`upload_failed` or `no_video_stream`:** see [upload errors](/api-reference/media/upload-media#common-upload-errors) and [job failure errors](/api-reference/overview#job-failure-errors) for the next step.
* **`file_too_large` or `video_too_long`:** check the [input-limit errors](/api-reference/overview#common-error-payloads).

## API key or request rejected

For `401 Unauthorized`, check that you are sending your API key in the `X-API-Key` header. Follow the [authentication guide](/authentication) or [find out how to get an API key](/help/faq#where-do-i-find-my-api-key).

For `400`, `403`, or `404`, read the response's error message and compare it with the [API error reference](/api-reference/overview#error-codes). The [common error payloads](/api-reference/overview#common-error-payloads) explain invalid settings and plan restrictions.

## Job queued or taking longer than expected

See the [processing-time FAQ](/help/faq). Through the API, use your job ID to [check the result](/api-reference/results/get-job-results).

If you receive `429`, check the specific error: rate, queue, concurrency, and plan limits need different responses. See [common error payloads](/api-reference/overview#common-error-payloads) and [rate limits](/api-reference/overview#rate-limits).

## Processing failed

Find the returned error in [Job failure errors](/api-reference/overview#job-failure-errors). It covers missing source files, unavailable voices, and videos without enough gaps for Standard AD.

If you are unsure which AD type to use, read [Standard AD vs Extended AD](/standard-vs-extended-ad).

## Credits or downloads

For questions about your balance or usage, see [Credits & Usage](/help/credits-and-usage). For download steps, see [Export and download](/dashboard/timeline-editor#5-export-and-download). API users can find returned files and text in [Get job results](/api-reference/results/get-job-results).

## Still need help?

[Contact support](/help/contact) with the error message and the steps that led to it. The support page lists the details that help us investigate.