К содержимому
Блог

Первый запрос к LLM API через cURL

Первый запрос к 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 могут различаться; не сокращайте идентификатор и не добавляйте номер версии по памяти.

bash
: "${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, выпускать ключ и переключать модель.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.