# When a download fails

> Every Qteros error code, what the stage number means and a next step for each: 4.215, 4.645, 429, 403, 502, expired links and connection drops.

Canonical: https://qteros.com/when-a-download-fails/
Last updated: 2026-11-22

## How to read the status line

A failure looks like this: `Conversion stopped — code 4.215`. The first number is the **stage** that stopped; the second is the **reason** it stopped. Some reasons are worth retrying immediately, some need a different video and one needs a different format.

## The stages

| Stage | What was happening |
| --- | --- |
| 1 | Authorisation: the relay asking the converter service for a session key. |
| 2 | Setup: the key being exchanged for a one-use conversion address. |
| 3 | Conversion: the video being checked and extracted. |
| 4 | Progress: the finished file being polled and handed over. |

## The reasons

| Code | Meaning | What to do |
| --- | --- | --- |
| 4.215 | The video is longer than the chosen format allows (MP4: 30 minutes). | Use MP3 if you only need the audio; it runs to 150 minutes. The status line offers this button directly. |
| 4.645 | YouTube does not serve this video to the converter's region. | Nothing on this page can change a region block. Try a different upload of the same material. |
| 429 (any stage) | Rate limit: too many conversions in a short time. | Wait about a minute and press the format button again. |
| 403 (any stage) | The upstream service refused this request. | Try once more; the relay rotates its egress address. If it persists, try another video. |
| 502 (any stage) | The relay got no usable answer from upstream. | Try again in a moment. If every video fails, the upstream service is having an outage. |
| net | The browser lost its connection to the relay. | Check the internet connection and start again. Keep the tab in the foreground. |
| 2 (progress stage) | The signed download link expired before the file was opened. | Convert the link again and press Download as soon as it appears. |
| 1.0 | Authorisation failed outright. | Reload the page and try again. If it repeats for every link, the service is unavailable. |

## Things that are not errors

- **The field says “that does not look like a YouTube video link”.** The address has no 11-character video id. A channel, playlist, search page or link shortener will do this; open the actual video and copy its address.

- **MP4 is greyed out on a search result.** The duration is over 30 minutes. MP3 remains available if the video is within 150 minutes.

- **Safari asks something before downloading.** That is iOS asking where to keep the file, not a failure. Allow the download and look in Files → Downloads.

- **The file plays but shows no picture.** You downloaded MP3, which is audio only. Convert again and choose MP4 for video.

## If nothing works

Try one short, public video as a control. If that also fails at stage 1 or 2 for every attempt, the problem is the service rather than your link; wait a little and try again. If only one video fails, the video is the problem — private, removed, region-locked or too long. You can report a persistent fault through the [contact page](https://qteros.com/contact/), including the code and the video address.
