Подключение Factory Droid CLI

Сложность ⌨️ Продвинутый　|　Формат API Совместимый с OpenAI　|　base_url https://byesu.com/v1

Данные подключения

Адрес APIhttps://byesu.com/v1

Ключ APIsk-xxxxxxxxСоздать в консоли →

Модельgpt-5.5

Формат API OpenAI совместимо · имена моделей — по консоли

Factory Droid CLI (droid) — это терминальный AI-агент для программирования от Factory AI, который прямо из командной строки может читать код, исправлять баги, выполнять рефакторинг и писать новые функции. Он поддерживает собственные модельные эндпоинты, поэтому бэкенд для вывода (inference) можно переключить на Byesu API.

Перед началом

Сначала зайдите в Консоль → Токены и создайте API-токен (в формате sk-xxxx), а также выберите для токена правильную группу — группа определяет, какие модели вам доступны и по какому маршруту пойдёт запрос. Подробнее см. Выбор группы.

Шаг 1: установка Droid CLI

Windows

irm https://app.factory.ai/cli/windows | iex

macOS / Linux

curl -fsSL https://app.factory.ai/cli | sh

После завершения установки обновите PATH согласно подсказкам, а также один раз войдите под бесплатным официальным аккаунтом Factory (это нужно только для аутентификации самого клиента и не влияет на то, что модели идут через byesu).

Примечание для Windows

Если возникает ошибка прав доступа или политики выполнения: запустите PowerShell от имени администратора и выполните Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

Шаг 2: настройка подключения к byesu

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

Способ 1 (самый быстрый): скрипт в один клик

После запуска просто введите по подсказкам base_url и API Key — скрипт сам пропишет файл конфигурации:

Windows

iex (irm 'https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.ps1')

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/QuantumNous/new-api-docs/refs/heads/main/helper/factory-cli-setup.sh | bash

• В поле base_url введите: https://byesu.com/v1
• В поле API Key введите: созданный вами в консоли byesu токен sk-xxxx

Способ 2 (вручную): редактирование файла конфигурации

Отредактируйте ~/.factory/config.json (в Windows это %USERPROFILE%\.factory\config.json) и добавьте в массив custom_models записи о моделях byesu:

{
  "custom_models": [
    {
      "model_display_name": "GPT-5.5 [byesu]",
      "model": "gpt-5.5",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Claude Opus 4.8 [byesu]",
      "model": "claude-opus-4-8",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    },
    {
      "model_display_name": "Gemini 3.1 Pro [byesu]",
      "model": "gemini-3.1-pro-high",
      "base_url": "https://byesu.com/v1",
      "api_key": "sk-xxxx",
      "provider": "openai",
      "max_tokens": 128000
    }
  ]
}

Описание полей:

• model: реальное имя модели на byesu (например, gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high); обязательно убедитесь, что группа вашего токена поддерживает эту модель.
• base_url: всегда https://byesu.com/v1 (формат, совместимый с OpenAI, с /v1).
• api_key: ваш токен sk-xxxx.
• provider: везде указывайте openai.
• model_display_name: имя, отображаемое в меню выбора в CLI, можно задать любое.

Использование нативного формата Anthropic

Выше используется совместимый с OpenAI эндпоинт (самый простой вариант). Если для какой-то записи нужно использовать нативный протокол Anthropic, измените у этой записи provider на anthropic, а base_url — на https://byesu.com без /v1. Обычно достаточно оставить openai + https://byesu.com/v1.

Шаг 3: запуск и проверка

Запустите в каталоге проекта:

cd /path/to/your/project
droid

После входа в интерактивный интерфейс используйте /model (или меню выбора модели при запуске), чтобы переключиться на только что настроенную модель … [byesu], и задайте любой вопрос, попросив прочитать файл или объяснить фрагмент кода. Если ответ приходит нормально — подключение прошло успешно.

Застряли?

• 401 / Unauthorized: неверно указан api_key или пропущен префикс sk-; убедитесь, что токен не отключён. Подробнее см. Частые ошибки #auth.
• Нет доступного канала / no channel: текущая группа токена не поддерживает указанную model, выберите другую модель из этой группы или заново выберите группу. Подробнее см. Частые ошибки #no-channel.
• Недостаточно средств / 402: на счёте недостаточно баланса, сначала пополните его. Подробнее см. Частые ошибки #balance.
• Сбой соединения / 404: неверно указан base_url — для формата, совместимого с OpenAI, он должен быть https://byesu.com/v1 (с /v1).

Больше способов диагностики см. в разделах Частые ошибки и Выбор группы.