Goose API: подключение и настройка моделей
Goose подключается к шлюзу как OpenAI-совместимый провайдер. В переменных окружения хост и путь задаются раздельно: хост без пути, путь в отдельной переменной.
- Тип: Агент в терминале
- Протокол: OpenAI Chat Completions
- Статус: Работает
- Версия при сверке: 1.52.0
Что заработает
| Возможность | Отметка | Примечание |
|---|---|---|
| Чат | Да | |
| Потоковый ответ | Да | |
| Вызов инструментов | Да | Работает у моделей с поддержкой инструментов. |
Настройка
Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.
Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/ (bash: ~/, bash на macOS: ~/), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.
Ключ в переменной окружения
macOS и Linux
read -rs RELAY_API_KEY && export RELAY_API_KEYWindows PowerShell
$env:RELAY_API_KEY = "YOUR_API_KEY"Windows cmd
set "RELAY_API_KEY=YOUR_API_KEY"- Установите Goose по официальной инструкции и задайте ключ в переменной
RELAY_API_KEY. - Задайте
OPENAI_HOSTсо значениемhttps://без пути иrelay-llm.ru OPENAI_BASE_PATHсо значениемv1/. Ключ передайте вchat/ completions OPENAI_API_KEY. - Выберите провайдера и модель:
GOOSE_PROVIDER=,openai GOOSE_MODEL=. Тот же выбор делает командаgpt-5.6-luna goose configure. - Для постоянной настройки заведите JSON-файл провайдера в каталоге
custom_providers. В нёмbase_urlсодержит полный маршрут.
Переменные и запуск
macOS и Linux
export OPENAI_HOST="https://relay-llm.ru"
export OPENAI_BASE_PATH="v1/chat/completions"
export OPENAI_API_KEY="$RELAY_API_KEY"
export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="gpt-5.6-luna"
goose sessionWindows PowerShell
$env:OPENAI_HOST = "https://relay-llm.ru"
$env:OPENAI_BASE_PATH = "v1/chat/completions"
$env:OPENAI_API_KEY = $env:RELAY_API_KEY
$env:GOOSE_PROVIDER = "openai"
$env:GOOSE_MODEL = "gpt-5.6-luna"
goose sessionWindows cmd
set "OPENAI_HOST=https://relay-llm.ru"
set "OPENAI_BASE_PATH=v1/chat/completions"
set "OPENAI_API_KEY=%RELAY_API_KEY%"
set "GOOSE_PROVIDER=openai"
set "GOOSE_MODEL=gpt-5.6-luna"
goose sessionСвой провайдер
~/.config/goose/custom_providers/gateway.json
%APPDATA%\Block\goose\config\custom_providers\gateway.json
{
"name": "gateway",
"engine": "openai",
"display_name": "Gateway",
"api_key_env": "RELAY_API_KEY",
"base_url": "https://relay-llm.ru/v1/chat/completions",
"models": [{ "name": "gpt-5.6-luna", "context_limit": 128000 }],
"supports_streaming": true,
"requires_auth": true
}Проверка
Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.
macOS и Linux
curl https://relay-llm.ru/v1/key \
-H "Authorization: Bearer $RELAY_API_KEY"Windows PowerShell
curl.exe https://relay-llm.ru/v1/key `
-H "Authorization: Bearer $env:RELAY_API_KEY"Windows cmd
curl https://relay-llm.ru/v1/key ^
-H "Authorization: Bearer %RELAY_API_KEY%"Затем проверьте сам клиент.
Выполните goose run --text "ping" или напишите в сеансе goose session. Ответ модели и запись в журнале кабинета подтверждают подключение.
Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.
Ограничения протоколов
OpenAI Chat Completions
Работают чат-модели каталога по пути /. Не поддерживаются /, /, /, /, Assistants и Realtime: функции клиента, которым они нужны, не заработают.
Ловушки
- У переменных путь отдельно от хоста, у JSON-файла
base_urlсодержит полный маршрут с/. Не смешивайте две формы.chat/ completions - Ключ из
api_key_envGoose хранит в связке ключей системы, а без доступа к ней в файлеsecrets.yaml. В JSON-файл ключ не вписывается. - Сторонняя страница показывает другую запись адреса. Верьте официальной документации и проверяйте пробным запросом.
- Модель в
modelsперечисляется вручную вместе с окном контекста: поставьте то, которое указано в каталоге.
Ссылки
Официальная документация: Goose API: подключение и настройка моделей
Подключение клиентов: общие сведения и все клиенты