К содержимому

Goose API: подключение и настройка моделей

Goose подключается к шлюзу как OpenAI-совместимый провайдер. В переменных окружения хост и путь задаются раздельно: хост без пути, путь в отдельной переменной.

  • Тип: Агент в терминале
  • Протокол: OpenAI Chat Completions
  • Статус: Работает
  • Версия при сверке: 1.52.0
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
Вызов инструментовДаРаботает у моделей с поддержкой инструментов.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/.zshrc (bash: ~/.bashrc, bash на macOS: ~/.bash_profile), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.

Ключ в переменной окружения

macOS и Linux

bash
read -rs RELAY_API_KEY && export RELAY_API_KEY

Windows PowerShell

bash
$env:RELAY_API_KEY = "YOUR_API_KEY"

Windows cmd

bash
set "RELAY_API_KEY=YOUR_API_KEY"
  1. Установите Goose по официальной инструкции и задайте ключ в переменной RELAY_API_KEY.
  2. Задайте OPENAI_HOST со значением https://relay-llm.ru без пути и OPENAI_BASE_PATH со значением v1/chat/completions. Ключ передайте в OPENAI_API_KEY.
  3. Выберите провайдера и модель: GOOSE_PROVIDER=openai, GOOSE_MODEL=gpt-5.6-luna. Тот же выбор делает команда goose configure.
  4. Для постоянной настройки заведите JSON-файл провайдера в каталоге custom_providers. В нём base_url содержит полный маршрут.

Переменные и запуск

macOS и Linux

bash
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 session

Windows PowerShell

bash
$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 session

Windows cmd

bash
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

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

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Выполните goose run --text "ping" или напишите в сеансе goose session. Ответ модели и запись в журнале кабинета подтверждают подключение.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • У переменных путь отдельно от хоста, у JSON-файла base_url содержит полный маршрут с /chat/completions. Не смешивайте две формы.
  • Ключ из api_key_env Goose хранит в связке ключей системы, а без доступа к ней в файле secrets.yaml. В JSON-файл ключ не вписывается.
  • Сторонняя страница показывает другую запись адреса. Верьте официальной документации и проверяйте пробным запросом.
  • Модель в models перечисляется вручную вместе с окном контекста: поставьте то, которое указано в каталоге.

Официальная документация: Goose API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key