Подключение и использование | Документация API

При неудачном вызове или прерывании беседы сначала проверьте минимальным запросом три вещи: аутентификацию, путь эндпоинта и доступность модели.

Не удается подключиться к платформе?

Проверьте:

Правильно ли настроен ключ, нет ли лишних пробелов или переводов строк.
Правилен ли базовый URL и нет ли повторяющихся путей.
Соответствует ли путь протоколу клиента, например OpenAI-совместимый путь для OpenAI-клиента.
Не блокируют ли запросы локальная сеть, корпоративный прокси, межсетевой экран, DNS или проверка HTTPS.
Не истек ли ключ, не удален ли он и не принадлежит ли ограниченному аккаунту.

Для OpenAI-совместимых вызовов проверьте минимальный непотоковый запрос:

bash

curl https://api.apihop.ai/openai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      { "role": "user", "content": "Reply with OK only." }
    ],
    "stream": false
  }'

Если он не проходит, причина обычно в сети, аутентификации, настройке пути, разрешениях модели или статусе аккаунта.

Модель выбрана, но ответа нет или возникает ошибка?

Частые причины:

ID модели неверен или не совпадает со списком платформы.
Модель временно недоступна или не разрешена ключу.
Формат запроса неверен: например, имена, вложенность или типы полей.
Недостаточно средств, слишком длинный контекст или вывод либо истекло время ожидания сервиса.
Сторонний клиент неправильно обрабатывает поток или ответы об ошибках.

Скопируйте точный ID из консоли или списка, проверьте минимальное тело и постепенно верните контекст и параметры.

Что делать при ошибке или разрыве чата?

Определите этап сбоя:

До начала запроса: проверьте аутентификацию, путь, модель и параметры.
Во время потока: проверьте тайм-аут клиента, цепочку прокси и разбор SSE.
При длинном контексте или выводе: проверьте размер запроса, лимиты вывода и тайм-аут сервиса.

Рекомендуемые действия:

Прочитайте конкретные поля ошибки.
Временно отключите поток, чтобы отличить сбой модели от ошибки разбора потока.
Добавьте повторы с задержкой для 429, нестабильной сети и некоторых ошибок 5xx.
Передавайте нужный контекст при повторе, не предполагая хранения состояния беседы сервером.
Если проблема остается, сохраните X-Request-ID.