Проверьте подключение

Проверьте публичный адрес, TLS и бесплатный каталог до платной пробы.

Задайте BASE_URL как корневой HTTPS-адрес API без завершающего / и без /v1, а API_KEY передайте из хранилища секретов. OpenAI-совместимые SDK используют ${BASE_URL}/v1, Anthropic-совместимые — BASE_URL.

Используйте точный публичный адрес нужного протокола: ${BASE_URL}/v1 для OpenAI-совместимого клиента; BASE_URL для Anthropic-совместимого. Не копируйте URL с ключом. Проверяйте сеть до генерации: каталог моделей не списывает кредиты.

Сначала бесплатные проверки

Отправьте GET /healthz на BASE_URL. Ответ со статусом ok подтверждает доступность HTTP-сервиса. Доступ к конкретной модели проверяйте отдельно.
Проверьте HTTPS и правильный базовый адрес. Сам endpoint Messages — /v1/messages, хотя его base URL не содержит /v1.
Используйте GET /v1/models с ключом, чтобы разделить сетевую, авторизационную и каталожную проблему.
Если curl работает, а клиент нет, сравните протокол, ID модели и источник credential с совместимостью клиентов.
Запустите doctor для бесплатных проверок клиента. Только явный --probe --yes допускает платный inference.

Разделите сеть и доступ

bash

curl -i --max-time 10 "$BASE_URL/healthz"
printf 'Authorization: Bearer %s\n' "$API_KEY" \
  | curl -q -H @- -i --max-time 10 "$BASE_URL/v1/models"

Первая команда должна вернуть HTTP 200 и {"status":"ok"}. Это подтверждает, что публичный сервис отвечает; проверка не подтверждает ключ, доступность модели или успешную генерацию. Вторая проверяет одновременно HTTPS, ключ и доступ к каталогу. HTTP 200 с data подтверждает, что сервис видит ключ; 401 или 403 направляет к авторизации, а 404 у конкретного ID модели — к каталогу. Ни одна из бесплатных проверок не гарантирует успех платного запроса к модели. Не записывайте команду с подставленным секретом в отчёт или скриншот.

Наблюдение	Следующая проверка
Не определяется домен или соединение не устанавливается	Проверьте DNS, прокси и разрешение исходящего HTTPS до публичного hostname. Сохраните время и текст ошибки клиента без секретов.
Ошибка проверки TLS	Проверьте системное время и доверенное хранилище сертификатов устройства или прокси. Не отключайте проверку сертификата.
`/healthz` работает, но каталог отвечает 401/403	Проверьте заголовок Bearer, срок действия ключа, организацию и права. Новая платная генерация не исправит авторизацию.
Каталог работает, но AI-клиент нет	Сравните base URL, протокол, канонический ID модели и способ передачи credential с матрицей клиентов.
API отвечает, но поток обрывается	Проверьте последнее SSE-событие и таймауты собственного клиента; сохраните тот же ключ идемпотентности до решения о повторе.

При сбое DNS или TLS не отключайте проверку сертификата ради обхода. Передайте публичный hostname, время, безопасный код и ID запроса при наличии. Если запрос дошёл до API и получил ошибку, откройте разбор ошибок.