Диагностика и частые ошибки
Пошаговая проверка шлюза, ключа и модели; значения кодов HTTP и проблемы IDE и потока.
provider/example-model — только образец формата ID. Перед запуском любого запроса скопируйте действующий ID в каталоге моделей или через GET /api/v1/models. Цены, лимиты и доступность также проверяйте в кабинете.
Четыре проверки
- Проверьте сервис без ключа:
GET /health. - Проверьте ключ:
GET /api/v1/modelsдолжен вернуть каталог. - Отправьте короткий запрос с актуальным ID из каталога и
"stream":false. - Только после успешного ответа включайте IDE, поток и сложные параметры.
curl -sS -o /dev/null -w '%{http_code}\n' \
https://api.ai.wiky.su/v1/models \
-H "Authorization: Bearer $WIO_API_KEY"Коды ответа
| Код | Что сделать |
|---|---|
| 400 | Проверьте JSON, параметры и полный ID. Скопируйте актуальный ID из каталога или GET /api/v1/models. |
| 413 | Уменьшите размер тела запроса. |
| 401 | Ключ отсутствует, неверен или отозван. Проверьте заголовок и кабинет. |
| 429 | Бесплатный лимит исчерпан. Посмотрите время обновления в кабинете. |
| 502, 503, 504 | Временный сбой шлюза или провайдера. Повторите позже или смените маршрут. |
Временные ошибки повторяйте ограниченное число раз с увеличивающейся задержкой. 400 и 401 требуют исправления запроса или ключа.
Адрес, маршрут и IDE
- 404 или повторный префикс /api/v1. OpenAI-клиенту задайте
https://api.ai.wiky.su/v1, Anthropic-клиенту —https://api.ai.wiky.su. - Неизвестная модель. Скопируйте полный ID из
/api/v1/models. - cURL работает, IDE нет. Проверьте переменную в среде запуска редактора и перезапустите его.
- Текст работает, инструменты нет. Проверьте другой маршрут: расширенные функции зависят от адаптера.
Ответ не отображается сразу
Для Chat Completions задайте "stream":true и запустите curl -N. Текст идёт частями в choices[0].delta.content, успешное завершение помечено [DONE]. После HTTP 200 проверяйте события: поток может завершиться ошибкой вместо [DONE]. Если нужен один JSON-объект, укажите "stream":false явно, особенно для /api/v1/responses, где поток включён по умолчанию.
Ключ стал публичным
Отзовите ключ в кабинете, создайте новый и обновите его в приложениях и CI. Перед отправкой логов удалите заголовки авторизации, ключи и приватные данные. Для сообщения об ошибке достаточно HTTP-кода, времени и ID маршрута.
Повторить быстрый старт