Skip to main content

Краткий ответ

502 — это временная ошибка, и на вашей стороне не требуется никаких изменений конфигурации:
  1. Корневая причина — автоматический перезапуск контейнера сервиса — в течение окна перезапуска веб-консоль недоступна, а API возвращает 502; это одно и то же событие.
  2. Восстановление обычно происходит автоматически в течение 1 минуты — подождите 30–60 секунд и повторно отправьте запрос.
  3. Неудачные вызовы никогда не тарифицируются — во время 502 запрос фактически не доходит до сервиса, поэтому запись о тарификации не создаётся.
  4. Добавьте автоматические повторные попытки на стороне клиента — одна повторная попытка примерно через 30 секунд без проблем перекроет всё окно перезапуска.

Что происходит

502 Bad Gateway означает: шлюзовой слой получил ваш запрос, но не получил ответа при его пересылке в backend-сервис. На APIYI подавляющее большинство кратковременных 502 вызвано автоматическим перезапуском контейнера backend-сервиса. Пока backend-процесс временно недоступен:
  • Веб-консоль (панель управления, страницы пополнения и т. д.) не загружается или показывает ошибки
  • API (api.apiyi.com и все остальные эндпоинты) возвращает 502
Оба элемента работают через один и тот же сервис, поэтому они сбоят вместе и восстанавливаются вместе. Как только обнаруживается аномалия, система автоматически завершает перезапуск — весь процесс обычно занимает не более 1 минуты и не требует ручного вмешательства.
Этот тип 502 никак не связан с вашим кодом, ключом, балансом или сетевой конфигурацией. Если вы видите это впервые, на стороне клиента нечего отлаживать — подождите 30–60 секунд и повторите попытку; в подавляющем большинстве случаев сервис уже восстановился.

Что следует сделать

1

Шаг 1: Подождите 30–60 секунд, затем повторно отправьте запрос

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

Шаг 2: Если веб-консоль не загружается, выполните принудительное обновление страницы

После восстановления браузер всё ещё может показывать кэшированную страницу ошибки. Используйте Ctrl+Shift+R (Windows) или Cmd+Shift+R (Mac), чтобы принудительно обновить страницу и увидеть обычный интерфейс.
3

Шаг 3: Если 502 сохраняется более 5 минут, обратитесь в поддержку

Кратковременная перезагрузка никогда не длится более нескольких минут. Если 502 сохраняется более 5 минут, это не обычная автоматическая перезагрузка — пожалуйста, свяжитесь с нами через способы связи в нижней части этой страницы, указав примерное время возникновения (с часовым поясом, например 14:30 (UTC+8)).

Добавление автоматических повторных попыток к программным вызовам

Если ваша нагрузка чувствительна к доступности, добавьте автоматические повторные попытки для временных ошибок вроде 502 на стороне клиента — одна повторная попытка примерно через 30 секунд покрывает всё окно перезапуска.
Применяйте эту стратегию повторных попыток только к ошибкам типа 502/503, когда запрос так и не дошёл до сервиса. Запросы, прерванные таймаутом на стороне клиента (или 524), могут по-прежнему выполняться на стороне сервера и тарифицируются как обычно — бездумное повторение таких запросов приводит к двойному списанию. Для этого класса проблем см. Как избежать таймаутов API.
Для высокочастотных нагрузок вы также можете быстро проверять с помощью экспоненциальной задержки (1 секунда, затем 2, затем 4) — 502 из-за кратковременного сетевого сбоя обычно исчезают в течение нескольких секунд. Если эти попытки всё равно не увенчаются успехом, вернитесь к интервалу в 30 секунд, чтобы покрыть случай перезапуска контейнера.

Часто задаваемые вопросы

Нет. 502 означает, что запрос фактически так и не дошёл до backend-сервиса — обращения к модели не было, поэтому ничего не появится в ваших записях тарификации.Это также удобный диагностический признак: если у неудачного запроса нет записи тарификации в вашем журнале вызовов, значит, он не обрабатывался на стороне сервера, и вы можете безопасно отправить его повторно.
  • 502: backend-сервис временно недоступен (идёт перезапуск контейнера). Подождите 30-60 секунд и повторите попытку; не тарифицируется.
  • Таймаут / разорванное соединение: таймаут вашего клиента слишком короткий — сервер может всё ещё выполнять запрос и тарифицировать его обычным образом. См. Как избежать таймаутов API.
  • 429: достигнут лимит параллельных запросов или лимит запросов; это не связано с доступностью сервиса. См. Лимиты параллельных запросов API.
  • 524: вы используете эндпоинт CDN (api-cf.apiyi.com) с запросом, превышающим примерно 100 секунд — переключитесь на другой эндпоинт.
Это требует совершенно разных действий: напрямую повторно отправлять следует только 502/503.
Веб-консоль и API работают поверх одного и того же сервиса. Во время перезапуска контейнера оба становятся недоступны одновременно и восстанавливаются одновременно — так что «сайт тоже недоступен» как раз и подтверждает, что это временный инцидент на стороне платформы, а не проблема в конфигурации вашего клиента.
Нет — это не регулярное явление. Временные 502 обычно связаны с резкими всплесками трафика и возникают нерегулярно.По состоянию на август 2026 года мы обновляем и масштабируем backend-серверы, что значительно снизит частоту таких временных 502. При любом инциденте на стороне платформы мы сразу публикуем обновления статуса и ход восстановления в ленте текущего статуса.
Два быстрых способа проверки:
  1. Откройте веб-консоль: если api.apiyi.com возвращает 502, а консоль тоже не загружается, скорее всего, это временный перезапуск на стороне платформы — подождите минуту.
  2. Смените сеть: попробуйте мобильный интернет (другой оператор), чтобы загрузить консоль, или выполните команду ниже. Если там всё работает, проблема в вашей локальной сети или прокси.
Если всё по-прежнему возвращает 502 в другой сети более 5 минут, обратитесь в поддержку.

Связанная документация

Как избежать тайм-аутов API

Настройки тайм-аута, задержка reasoning-моделей и диагностика 524

Нужен ли мне прокси для использования API?

Примечания по прямому подключению и сетевые требования

Где находятся серверы APIYI?

Расположение узлов, тестирование задержки и рекомендации по покупке

Доступность сервиса и SLA

Обязательства по доступности и реагирование на инциденты

Свяжитесь с нами

Поддержка WeCom

QR-код поддержки WeComСканируйте QR-код или нажмите на эту карточку, чтобы напрямую связаться со службой поддержкиРазбор постоянных сообщений об ошибке 502 и первичная обработка инцидентов

Электронная почта

Поддержка: [email protected]Бизнес: [email protected]