---
title: "goose: свой OpenAI-совместимый провайдер, настройка | BroadRouter"
description: "Как подключить ИИ-агента goose к BroadNet Inference как пользовательский провайдер OpenAI Compatible: через goose Desktop, goose configure или JSON-файл."
url: https://broadrouter.com/ru/guides/goose-custom-provider/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/goose-custom-provider/) (обновлён 2026-11-16).

# BroadNet Inference в goose: пользовательский провайдер

Обновлено 2026-11-16

Добавьте в goose пользовательский провайдер типа OpenAI Compatible с API URL https://inference.broadnet.ai/v1/chat/completions, ключом BroadNet и моделями, например broadnet/glm-5.3. Сделать это можно кнопкой Add Custom Provider в goose Desktop, командой goose configure в терминале или JSON-файлом в ~/.config/goose/custom\_providers/. goose опирается на вызов инструментов, поэтому начните с GLM 5.3 или Qwen3.8 27B.

goose — open-source ИИ-агент с десктопным приложением и CLI. Сервисы, которых нет среди встроенных, добавляются как **пользовательские провайдеры** (custom providers), и goose поддерживает OpenAI-совместимые. BroadNet Inference отдаёт стандартные chat completions, поэтому подключается именно так. BroadRouter — собственный сайт BroadNet. Шаги ниже повторяют [документацию goose по провайдерам](https://goose-docs.ai/docs/getting-started/providers/) для версии goose 1.59.

Документация goose предупреждает, что он “extensively uses tool calling” (перевод: «активно использует вызов инструментов»), а модели без этой возможности могут только общаться, и то при отключении всех расширений. BroadNet указывает вызов инструментов для GLM 5.3 и Qwen3.8 27B, поэтому для работы агента берите одну из них.

## Вариант 1: goose Desktop

1.  Откройте боковую панель, нажмите **Settings**, затем вкладку **Models**.
    
2.  Нажмите **Configure providers**, затем **Add Custom Provider** внизу.
    
3.  Заполните поля:
    
    | Поле | Значение |
    | --- | --- |
    | Provider Type | **OpenAI Compatible** |
    | Display Name | BroadNet Inference |
    | API URL | `https://inference.broadnet.ai/v1/chat/completions` |
    | API Key | ваш ключ BroadNet |
    | Available Models | `broadnet/glm-5.3, broadnet/qwen3.8-27b` |
    | Streaming Support | включено |
    
4.  Нажмите **Create Provider**, затем выберите этот провайдер и модель.
    

## Вариант 2: goose CLI

Запустите `goose configure`, выберите **Custom Providers**, затем **Add A Custom Provider** и ответьте на вопросы теми же значениями: тип API OpenAI Compatible, API URL из таблицы выше, аутентификация **Yes** со статическим API-ключом, список моделей через запятую и включённый стриминг.

## Вариант 3: JSON-файл

Создайте `~/.config/goose/custom_providers/broadnet.json` (в Windows — в `%APPDATA%\Block\goose\config\custom_providers\`):

```json
{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}
```

Затем запустите сессию с этим провайдером:

```bash
export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet
```

Файл можно положить в репозиторий для всей команды: ключ остаётся в переменной окружения.

## Проверка

Начните с простого вопроса, например «что ты умеешь?». Если пришёл ответ, подключение работает. Затем попросите о чём-нибудь, для чего нужно одно из включённых расширений. Если goose вызвал инструмент, вызов инструментов тоже работает. Если он отвечает только текстом и никогда не вызывает инструменты, переключитесь на `broadnet/glm-5.3`.

## Цены в goose

goose умеет оценивать расходы, если у каждой модели в JSON-файле заданы `input_token_cost` и `output_token_cost` в USD за токен. Возьмите цифры на [странице цен](https://broadrouter.com/ru/pricing/) BroadNet и разделите цену за 1 млн токенов на 1 000 000. Если хотя бы одного из этих полей нет, goose берёт цены из собственного каталога, а они могут не совпадать с ценами BroadNet.

## Решение проблем

-   **401.** Ключ неверен, истёк или исчерпал лимит, либо `BROADNET_API_KEY` не задана в оболочке, из которой запускается goose.
-   **404.** Проверьте API URL: он должен быть `https://inference.broadnet.ai/v1/chat/completions`. Проверьте, что ID модели точно совпадает с ID BroadNet. Для платных моделей нужно пополнить баланс; стартовый грант $5 покрывает только `broadnet/gemma-4-26b-a4b`, а её контекст в 32 768 токенов маловат для работы агента.
-   **Пустые ответы.** У DeepSeek V4.1 Flash, GLM 5.3 и Qwen3.8 27B рассуждения учитываются в лимите на выход. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **429.** Ключ с оплатой по факту допускает 30 запросов в минуту и не больше 4 одновременно. Две сессии goose на одной [сессии тарифа](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/) встают в очередь, потому что сессия тарифа обрабатывает один запрос за раз. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).

## Термины в этом руководстве

[Вызов инструментов (tool calling)](https://broadrouter.com/ru/glossary/tool-calling/)

Вызов инструментов (function calling) — это функция LLM API, при которой модель возвращает структурированный запрос на выполнение функции, заданной разработчиком, с аргументами в JSON. Приложение выполняет функцию и отправляет результат обратно; сама модель код никогда не выполняет.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[Стриминг (streaming)](https://broadrouter.com/ru/glossary/streaming/)

Стриминг — это способ возвращать ответ языковой модели небольшими частями (чанками) прямо во время генерации, а не одним ответом в конце. OpenAI-совместимые API передают поток через server-sent events, если в запросе stream равен true.

[Контекстное окно (context window)](https://broadrouter.com/ru/glossary/context-window/)

Контекстное окно — это максимальное число токенов, с которым языковая модель может работать в одном запросе. В него входят промпт, история диалога, описания инструментов, изображения и сгенерированный ответ, включая токены рассуждений. Всё, что не помещается, приходится обрезать, сжимать в краткое изложение или делить на несколько запросов.

[API-ключ (API key)](https://broadrouter.com/ru/glossary/api-key/)

API-ключ — это секретная строка, которая идентифицирует и авторизует клиента, вызывающего API. LLM API обычно ожидают его в заголовке Authorization: Bearer, и любой, у кого есть ключ, может отправлять запросы, оплачиваемые аккаунтом владельца ключа.

[Chat Completions API](https://broadrouter.com/ru/glossary/chat-completions-api/)

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

## Вопросы и ответы

### API URL в goose должен заканчиваться на /v1 или на /v1/chat/completions?

В примере пользовательского провайдера из документации goose указан полный URL chat completions, поэтому используйте https://inference.broadnet.ai/v1/chat/completions. Так goose будет работать через chat completions — именно этот формат отдаёт BroadNet.

### Какая модель BroadNet лучше всего работает с goose?

GLM 5.3 (broadnet/glm-5.3). Документация goose говорит, что он активно использует вызов инструментов, а BroadNet указывает инструменты только для GLM 5.3 и Qwen3.8 27B.

### Можно ли использовать goose на безлимитном тарифе BroadNet?

Тарифы покрывают только DeepSeek V4.1 Flash, а документация BroadNet не указывает для неё вызов инструментов. По словам goose, модели без вызова инструментов могут только общаться, и то с отключёнными расширениями, так что проверьте её, прежде чем брать месяц.

### Где goose хранит API-ключ?

В системной связке ключей (keychain) или в secrets.yaml, если keyring отключён. При настройке через JSON-файл goose вместо этого читает переменную, указанную в api\_key\_env.

## Похожие руководства

-   [Kilo Code и BroadNet Inference: провайдер OpenAI Compatible](https://broadrouter.com/ru/guides/kilo-code-openai-compatible/)
-   [BroadNet Inference в opencode: свой провайдер](https://broadrouter.com/ru/guides/opencode-custom-provider/)
-   [Как устроены безлимитные тарифы LLM API для агентов](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/)
-   [Коды ошибок BroadNet Inference и когда повторять запрос](https://broadrouter.com/ru/guides/errors-and-retries/)
-   [Все инструменты, которые работают с BroadNet Inference (на английском)](https://broadrouter.com/integrations/): SDK, агенты для программирования, чат-интерфейсы и инструменты автоматизации с точными настройками для каждого

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-goose-custom-provider&utm_content=page-cta) ·

**Источники**

-   [Документация goose, Model providers и Configure Custom Provider (дата обращения 2026-11-15)](https://goose-docs.ai/docs/getting-started/providers/)
-   [goose на GitHub (aaif-goose/goose), последняя версия v1.59.1 (дата обращения 2026-11-15)](https://github.com/aaif-goose/goose)
-   [Справочник API BroadNet Inference (дата обращения 2026-11-15) (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-goose-custom-provider&utm_content=sources)
