Тайм-аут OpenRouter: как найти причину обрыва запроса

При тайм-ауте OpenRouter определите, где остановился запрос: до соединения, до первого ответа или во время потоковой передачи. Сохраните тело ошибки, время и доступный ID запроса, прежде чем увеличивать ожидание или менять поставщика.

Здесь применяются общие методы диагностики HTTP и клиента. Новые реальные запросы к OpenRouter для этой статьи не выполнялись; она не утверждает, что платформа недоступна или конкретный поставщик виноват в вашем сбое.

Разделите три симптома

Ограничение частоты запросов отличается от тайм-аута. Для ошибки Kimi 429 есть отдельная инструкция — на английском.

Начните с клиента

Запишите библиотеку и версию, endpoint, модель и режим streaming. Уточните, делает ли SDK автоматические повторы: один видимый вызов может означать несколько попыток. У сервера приложения или промежуточного прокси может быть более короткий срок ожидания.

Если мониторинг позволяет, измеряйте отдельно соединение, время до первого байта и полную длительность. Получение заголовков не означает успешного завершения генерации. Не публикуйте API-ключи, заголовки авторизации и закрытый пользовательский ввод.

Сведите воспроизведение к одному запросу

1. Сохраните исходную ошибку и время.
2. Используйте небольшой разрешённый ввод и модель, доступную аккаунту.
3. Запишите число попыток. Для диагностики отключайте повторы только документированным способом своего клиента.
4. Меняйте один параметр за раз: прокси приложения, streaming или размер ввода.
5. При сравнении маршрутов проверяйте поддерживаемые параметры, не копируя настройки вслепую.

Успех небольшого запроса сужает поиск, но не доказывает надёжность production. Его сбой также требует журналов, чтобы определить проблемный уровень.

Учитывайте, чей сервис описывает справочник

Справочник ошибок OpenAI помогает различить проблемы соединения, ожидания и возвращённые API-ошибки. Он описывает OpenAI и его SDK, а не гарантии OpenRouter. Реальное исправление должно опираться на ответ шлюза и документацию установленного клиента.

Скриншот страницы OpenAI от 16 сентября 2026 года с исходным английским текстом. Это не консоль OpenRouter и не воспроизведённый нами сбой OpenRouter.

Не повторяйте побочные действия

Повторяйте только операции, которые допустимо выполнить снова. Ограничьте число попыток и учитывайте документированные рекомендации сервера. Неограниченный цикл может продолжать расходовать средства, не устраняя причину.

Upstream мог закончить работу до разрыва связи; приложение могло уже выполнить действие инструмента. Перед повтором хода агента сверьте состояние приложения и доступную историю запросов. Неполный поток сохраняйте как неполный: второй ответ нельзя просто приклеить к первому.

Для сходного симптома в клиенте для работы с кодом полезна инструкция по обрыву потока Codex. В обращение включите UTC-время, модель, обезличенный ID, версию клиента, streaming, тайм-ауты, число попыток и результат малого запроса. Проверка поставщика API дополнит запись сведениями о маршруте и списании. Успех после смены поставщика сам по себе не устанавливает причину прежнего сбоя.