BroadRouter
Начать

Zed и BroadNet Inference: OpenAI-совместимый провайдер

Обновлено

В settings.json редактора Zed добавьте провайдера в language_models.openai_compatible, например broadnet, с api_url = https://inference.broadnet.ai/v1 и списком available_models с ID моделей BroadNet, например broadnet/glm-5.3, где max_tokens равен размеру контекста. Ключ Zed читает из BROADNET_API_KEY, или его можно сохранить в Agent Settings.

Zed — редактор кода с открытым исходным кодом и встроенным агентом. Он подключается к любому серверу с OpenAI-совместимым API через тип провайдера openai_compatible. BroadNet Inference обслуживает стандартные chat completions по адресу https://inference.broadnet.ai/v1, так что подходит. BroadRouter — собственный сайт BroadNet; шаги ниже следуют документации Zed по доступу через API для Zed 1.28.

Настройка

  1. Получите ключ. Создайте ключ с оплатой по факту в консоли BroadNet или используйте ключ безлимитного тарифа.
  2. Добавьте провайдера. Либо откройте Agent Settings командой agent: open settings и нажмите Add Provider в разделе LLM Providers, либо отредактируйте settings.json напрямую:
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
  1. Передайте Zed ключ. Экспортируйте его перед запуском Zed или вставьте в настройки провайдера в Agent Settings. Вставленные ключи Zed хранит в системной связке ключей, а не в settings.json.
export BROADNET_API_KEY='your-broadnet-key'
  1. Проверьте. Откройте Agent Panel, выберите GLM 5.3 (BroadNet) в списке моделей и задайте простой вопрос по открытому файлу. Если пришёл ответ, подключение работает.

Что означают настройки

  • name — ID модели, который отправляет Zed. Указывайте ID BroadNet в точности, с префиксом broadnet/.
  • max_tokens в схеме Zed — это контекстное окно, а не лимит вывода. Укажите 1 048 576 для GLM 5.3 и DeepSeek V4.1 Flash и 262 144 для Qwen3.8 27B.
  • max_output_tokens ограничивает длину ответа. Значение 16 000 выше — наша рекомендация, а не лимит BroadNet. Рассуждения учитываются в нём, поэтому не ставьте его низким.
  • max_tokens_parameter: true заставляет Zed передавать лимит вывода как max_tokens, а не max_completion_tokens. Справочник API BroadNet описывает поле max_tokens.
  • images для OpenAI-совместимых моделей по умолчанию false. Включайте его только для моделей, которые принимают изображения: Qwen3.8 27B, DeepSeek V4.1 Flash и BroadNet Gemma 4 VL 26B.
  • reasoning_effort необязателен. Документация BroadNet советует low, если нужны более короткие рассуждения.

Какую модель выбрать

Задача Модель Почему
Правки агентом с инструментами broadnet/glm-5.3 BroadNet указывает tools и структурированный вывод; контекст 1M
Скриншоты и арабский текст broadnet/qwen3.8-27b Tools и ввод изображений; контекст 262K
Долгие чаты на тарифе с фиксированной ценой broadnet/deepseek-v4.1-flash Модель безлимитного тарифа; принимает изображения; tools у BroadNet не указаны

Для OpenAI-совместимых моделей Zed предполагает tools: true. Документация BroadNet не указывает вызов инструментов для DeepSeek V4.1 Flash, поэтому прежде чем на неё полагаться, проверьте на реальной задаче агента. Час Meteor ($1) — недорогой способ попробовать, прежде чем брать месяц Full Moon ($60).

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

  • 401. Ключ неверный, истёк или исчерпан. Если задан BROADNET_API_KEY, он важнее связки ключей; удалите переменную и перезапустите Zed, чтобы использовать сохранённый ключ.
  • 404 на каждый запрос. Проверьте, что api_url заканчивается на /v1. Затем убедитесь, что name в точности совпадает с ID BroadNet. Платным моделям нужно пополнение баланса; стартовый грант $5 покрывает только broadnet/gemma-4-26b-a4b.
  • Пустые ответы. Модель потратила бюджет вывода на рассуждения. Увеличьте max_output_tokens или задайте reasoning_effort равным low. Почему ответы приходят пустыми.
  • 429. Ключ с оплатой по факту допускает 30 запросов в минуту и 4 одновременно. Сессия тарифа выполняет один запрос за раз. См. ошибки и повторные запросы.
  • Удалённые проекты. Zed инициализирует провайдеров в локальном приложении, поэтому при работе по SSH ключ берётся из локальной связки ключей или локального окружения, а не с удалённой машины.

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

Из какой переменной окружения Zed берёт ключ своего провайдера?

Zed строит имя из ID провайдера в верхнем snake_case плюс _API_KEY. Провайдер с именем broadnet читает BROADNET_API_KEY. Непустая переменная имеет приоритет над ключом, сохранённым в связке ключей.

Работает ли модель BroadNet в Agent Panel редактора Zed?

Да. Доступ через API в Zed охватывает Zed Agent, Inline Assistant, сообщения коммитов и сводки тредов. Для OpenAI-совместимых моделей Zed предполагает поддержку инструментов, поэтому выбирайте GLM 5.3 или Qwen3.8 27B — у BroadNet они указаны с поддержкой tools.

Влияет ли это на предсказания правок в Zed?

Нет. Документация Zed говорит, что у edit prediction своя настройка провайдера в edit_predictions. Провайдер из этого руководства нужен для агента и других ИИ-функций Zed.

Почему Zed пишет, что модель работает только с Responses API?

С BroadNet такого быть не должно. Оставьте capabilities.chat_completions со значением по умолчанию true. BroadNet обслуживает /v1/chat/completions, а Responses API в списке не указывает.

Открыть в MarkdownСпросить ChatGPTСпросить ClaudeСпросить Perplexity