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

# Ошибки и безопасные повторы

> Как не создать второй платный запрос после сетевой ошибки.

Обычная HTTP-ошибка содержит error.code, error.message и идентификатор корреляции запроса. Сообщение не раскрывает внутренние маршруты, внутренний ID поставщика или секреты. В MCP результат ошибки инструмента помечен isError=true.

| Ситуация                                   | Действие                                                             |
| ------------------------------------------ | -------------------------------------------------------------------- |
| validation\_error / unsupported\_parameter | Исправьте форму до новой отправки                                    |
| unauthorized / insufficient\_scope         | Проверьте ключ и необходимые права                                   |
| api\_key\_daily\_budget\_exceeded          | Проверьте дневной бюджет и резервы                                   |
| insufficient\_balance                      | Проверьте доступный баланс                                           |
| quote\_exceeds\_limit                      | Получите новую цену и явно задайте допустимый предел                 |
| idempotency\_conflict                      | Не меняйте тело уже принятого запроса; используйте исходные данные   |
| model\_unavailable                         | Проверьте доступность операции; запрос мог быть отклонён до отправки |
| cancellation\_not\_safe                    | Отмена после отправки запрещена; дождитесь сверки                    |
| file\_not\_ready / file\_scanning          | Дождитесь проверки файла                                             |
| file\_expired                              | Срок хранения истёк                                                  |

При разрыве соединения результат не известен. Повторяйте тот же endpoint с прежним ключом credential, Idempotency-Key и телом. Сохранённый результат возвращается без второй отправки и списания. Не включайте слепой SDK retry со случайным новым Idempotency-Key.

HTTP 202 для медиа означает принятое задание. Для текстового пути он может означать незавершённую обработку; billing и сохранённый запрос остаются источником состояния. Проверьте историю и не выдавайте этот ответ за окончательный текст модели.