Устранение неполадок

На этой странице

Найдите симптом, который соответствует тому, что вы видите. Почти всегда быстрее всего диагностировать проблему на вкладке Logs — на ней показаны статус каждого запроса и характер сбоев (один ключ? одна модель? всё сразу?). См. Активность и журналы.

Запросы блокируются

Каждый запрос завершается ошибкой 402 `insufficient_credits`

Причина: модуль не включен для этого объекта или предоплаченный баланс исчерпан (на вкладке Overview будет показано "Your balance is depleted. Inference requests will be blocked until you top up."). Для ключей API объект, на котором Model Router не включен, вместо этого возвращает 403 "Model Router is not enabled for this facility".

Решение: включите Model Router на странице Welcome to Model Router (см. Начало работы), затем пополните баланс в разделе Budgets & Limits → Balance & Top-up. Запросы возобновляются в течение нескольких мгновений после зачисления средств на баланс. Чтобы проблема не повторялась, включите автоматическое пополнение. См. Бюджеты и пополнения.

Запросы завершаются ошибкой 402 `budget_exceeded`

Причина: достигнут лимит расходов. В сообщении об ошибке указано, какой период превышен (день / месяц / весь срок) и — для дневного и месячного лимитов — точное время сброса в часовом поясе вашего объекта. Это может быть лимит для всей учетной записи или лимит для конкретного ключа или подключенного сервиса (если лимит ограничен ими, в сообщении будет "This key's" / "This agent's").

Решение: дождитесь указанного времени сброса, повысьте лимит (Budgets & Limits → Spend Limits или в настройках ключа либо сервиса) или — для жесткого лимита на весь срок — используйте Reset hard cap. На странице Spend Limits точно видно, какие лимиты находятся в состоянии "Limit reached".

Запросы завершаются ошибкой 403 `content_policy_violation`

Причина: запрос совпал с фильтром контента в режиме block или сработала защита от внедрения запросов (prompt injection).

Решение: проверьте Settings → Guardrails. Если одной интеграции действительно нужны другие правила, используйте ее переключатель Override facility guardrails, а не ослабляйте политику для всего объекта. См. Защитные механизмы.

Запросы завершаются ошибкой 429

Причина: ключ или подключенный сервис превысил ограничение частоты Requests / min или Tokens / min.

Решение: сделайте паузу и повторите попытку или повысьте ограничения частоты в настройках ключа или сервиса (пустое значение = без ограничений). См. Ключи API.

Одна модель возвращает ошибки, остальные работают

Причина: модель может быть отключена для вашего объекта, исключена ограничением моделей для ключа, или у поставщика могут быть проблемы.

Решение: проверьте Settings → Models (включена ли модель?), список Restrict models для ключа и раздел Activity → Performance → Reliability & performance by model, где показана частота ошибок модели во времени.

Проблемы с ключами API

401 Unauthorized

Причина: при коде invalid_api_key ("Missing or invalid API key") заголовок Authorization: Bearer … отсутствует или имеет неверный формат. Без кода ("Invalid API key") ключ неизвестен (опечатка или старый секрет после rotate) или revoked.

Решение: проверьте формат заголовка и состояние ключа в разделе Settings → Service Access & API Keys. Повторно активируйте отозванный ключ или, если ключ был заменен, укажите в своем сервисе новый секрет.

Я потерял секрет ключа

Секрет показывается только один раз при создании, и восстановить его нельзя. Используйте Rotate — будет выдан новый секрет (показывается один раз), а ключ сохранит свою метку, лимиты и историю. Обновите все сервисы, которые используют этот ключ: "You will need to reconfigure any services still using the old key."

Ключ работает, но использование отображается под неверным именем

В разделах Activity и Logs ключи обозначаются своей меткой (Label). Измените ключ и задайте понятную метку; выдайте каждой системе собственный ключ, а не используйте один на всех.

Проблемы с агентами

Агент отображается как Offline

Причина: устройство выключено или не имеет подключения — это вопрос подключения устройства, а не настройки Model Router.

Решение: проверьте питание и сеть устройства. Его настройки доступа не затрагиваются, и он снова начнет работать, как только подключится.

Агент перестал отвечать на запросы к ИИ

Проверьте по порядку:

Баланс — исчерпанный баланс блокирует всех агентов (агент показывает состояние, требующее пополнения средств). Пополните баланс.
Лимиты для сервиса — Settings → Service Access & API Keys → Connected Services: показывает ли агент "Limit reached"? Повысьте лимит или дождитесь его сброса.
Лимиты учетной записи — Budgets & Limits → Spend Limits.
Журналы — отфильтруйте по агенту, чтобы увидеть фактическую ошибку в его запросах.

Вопросы о балансе и оплате

Данные о расходах отстают

Показатели Available balance и Spent today обновляются в реальном времени. Monthly usage сверяется с вашим балансом каждые 15 минут, поэтому самые свежие расходы могут появиться там через несколько минут. В истории транзакций показаны только пополнения и корректировки баланса, поэтому использование в ней никогда не отображается.

Автоматическое пополнение не сработало

Проверьте, нет ли на странице Balance & Top-up баннера: карта не добавлена, карта требует подтверждения или платеж по карте отклонен. Исправьте данные карты (Update card / Edit payment details) или пополните баланс вручную. Проверки автоматического пополнения выполняются примерно каждые 15 минут, поэтому после пересечения порога срабатывание может занять несколько минут.

Пополнение не удалось

"Additional card authentication is required. Please try again." — повторите попытку; банк может запросить подтверждение. "Top-up could not be completed." — платеж отклонен; проверьте карту или попробуйте другую сумму. Средства зачисляются только при успешном списании.

Деньги списаны, но баланс не изменился

Пополнения зачисляются мгновенно — обновите страницу. Если баланс по-прежнему не отражает успешное списание, запишите Transaction ID и Payment reference из панели сведений о транзакции (или из выписки по карте) и создайте запрос в службу поддержки.

Вопросы о журналах и аналитике

Только что отправленного запроса еще нет в Logs

Включите обновление Live (или нажмите Refresh now). Обычно запросы появляются в течение нескольких мгновений; при высокой нагрузке это может занять немного больше времени.

В журналах указана модель, которую я не запрашивал

Если вы отправили model: "auto", в журналах отображается модель, которую выбрал Auto Router, — откройте сведения о запросе, чтобы увидеть Requested model: auto. Это ожидаемое поведение. См. Models.

В строках указано "No charge"

Неудачные или пустые ответы, которые ничего не стоили, помечаются значком No charge — они записываются для полноты данных, но не расходуют баланс.

Экспорт CSV меньше ожидаемого

Необработанные выгрузки ограничены 25,000 строками — сузьте диапазон дат или используйте сводную выгрузку. Также учтите: "Summaries cover whole days, so a sub-day or graph selection is widened to full days."