Первый запрос к LLM API через cURL
Первый вызов удобно выполнить через cURL: между терминалом и API нет настроек редактора или SDK, которые могут заменить адрес, модель или заголовок. Начните с одного короткого сообщения. После успешного ответа переносите настройки в приложение.
Подготовьте ключ и модель
Создайте отдельный ключ в кабинете Relay. Передайте его процессу через RELAY_API_KEY. Секрет не вставляйте в команду буквальным значением: команды могут остаться в истории оболочки или записи экрана.
Откройте каталог и скопируйте идентификатор текстовой модели в RELAY_MODEL. Поддержку Chat Completions проверьте отдельно в ответе GET https://relay-llm.ru/api/public/models: для соответствующего public_id в protocols нужно openai_chat. Отсутствующее поле не подтверждает поддержку. Имя в заголовке карточки и идентификатор API могут различаться; не сокращайте идентификатор и не добавляйте номер версии по памяти.
: "${RELAY_API_KEY:?Передайте ключ через окружение}"
: "${RELAY_MODEL:?Выберите идентификатор из каталога}"
curl --silent --show-error --include \
"https://relay-llm.ru/v1/chat/completions" \
-H "Authorization: Bearer $RELAY_API_KEY" \
-H "Content-Type: application/json" \
--data "{\"model\":\"$RELAY_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Ответь одним словом: готово\"}]}"Команда рассчитана на Bash или совместимую оболочку. Идентификатор берите без изменений из каталога; произвольный пользовательский текст нельзя подставлять в JSON таким способом. Для приложения используйте JSON-сериализатор.
Прочитайте результат
При успехе найдите текст в choices[0].message.content. Заголовки нужны для диагностики, поэтому пример включает --include. Полный ключ в ответе не требуется и в поддержку не отправляется.
Если пришла ошибка, сохраните статус HTTP, код ошибки и request_id, если он присутствует. В справочнике ошибок описаны причины отказов и правила повтора. Исправление ключа не поможет ошибке формата тела, а другой идентификатор модели не исправит недостаточный баланс.
Перенесите рабочую конфигурацию
Для OpenAI-совместимого SDK базовый адрес: https://relay-llm.ru/v1. Полный маршрут /chat/completions SDK добавляет сам. Для Anthropic Messages базовый адрес другой: https://relay-llm.ru.
Сверьте перенос с быстрым стартом. Если cURL работает, а приложение нет, сравните фактический адрес и модель приложения с успешным запросом. Меняйте один параметр за раз. Это быстрее, чем одновременно переустанавливать SDK, выпускать ключ и переключать модель.