Troubleshooting
Диагностика, повторы и безопасность
Сначала определите границу сбоя: вход в панели управления, управление Key, оплата или модельный шлюз. Сохраняйте request_id, время и статус, но не передавайте полный Key.
Проверьте вход, Key, баланс и модели, затем выполните минимальный cURL. При успехе проверьте клиентскую конфигурацию; при ошибке используйте HTTP-статус и Usage.
- Сначала
- Проверить актуальные данные
- Минимальный тест
- cURL
- Связь
- request_id
- Не передавать
- Полный API Key
Порядок диагностики
- 1Убедитесь, что панель управления открывается и выполняет вход.
- 2Проверьте API Key, баланс и состояние аккаунта.
- 3Снова скопируйте Gateway, Key и ID модели.
- 4Вызовите GET /v1/models для проверки аутентификации.
- 5Отправьте минимальный непотоковый cURL.
- 6Перенесите те же значения обратно в SDK, CLI или IDE.
Матрица ошибок модели
| Симптом | Сначала проверить |
|---|---|
| 400 | JSON, типы, обязательные поля и параметры модели |
| 401 | Полный активный Key и Header |
| 402 / 403 | Баланс, аккаунт или доступ группы |
| 404 | Gateway, путь /v1, список моделей и протокол |
| 429 | Retry-After, параллелизм, частоту и upstream |
| 5xx / timeout | Доступность шлюза, временный upstream и таймаут клиента |
Ошибки входа
- Используйте способ входа, который сейчас предлагает страница.
- Пройдите проверку безопасности, показанную страницей.
- После завершения сессии войдите снова.
- Следуйте подсказке страницы, если регистрация требует входа или другого способа.
- Для ограниченного аккаунта обратитесь к оператору.
Аккаунт и оплата
| Симптом | Действие |
|---|---|
| Баланс не обновился | Обновите панель управления и проверьте записи покупок |
| Покупка недоступна | Следуйте текущей конфигурации и правам аккаунта |
| Запрос модели отклонён | Проверьте баланс, Key, модель и группу |
| Записи различаются | Сохраните время и данные страницы, обратитесь к оператору |
Ошибки API Key
- Ошибка создания: проверьте форму, аккаунт и права.
- 401: снова скопируйте полный Key и проверьте Header.
- Новый Key не работает: обновите Secret и перезапустите клиент.
- Перед удалением убедитесь, что Key больше не используется.
- При постоянной ошибке сохраните время, код и request_id.
Streaming и повторы
- Таймауты прокси и клиента должны покрывать первый Token и длинный ответ.
- Используйте SSE-совместимый proxy и отключите лишнюю буферизацию.
- Передавайте AbortSignal или закрывайте соединение при отмене.
- Ограниченно повторяйте только 429, временный 5xx или сетевой сбой с exponential backoff.
- Не начинайте запрос заново после начала ответа, если дубликат и дополнительная стоимость неприемлемы.
Данные для диагностики
| Можно предоставить | Нельзя предоставлять |
|---|---|
| UTC, request_id, ID связанной записи, HTTP-статус | Полный API Key или пароль аккаунта |
| Хост Gateway и путь без credential query | Authorization или x-api-key Header |
| Модель, клиент/версия, минимальные шаги | Секретный Prompt, полный ответ, личные данные |
| Обезличенный error type/code | Внутренние управляющие секреты |