Розділи бази знань ▾

Навігація

▸ Почніть тут За ролями

Категорії

Інструменти 52
Глосарій 12

Інструменти

GitHub Copilot BYOK — власні моделі замість квоти

BYOK (bring your own key) — офіційний механізм GitHub Copilot, який дозволяє підключити власного провайдера моделей і працювати в агентних сесіях на ньому, а не на вбудованих GPT та Claude. З січня 2026 підтримується будь-який OpenAI-сумісний endpoint, з 23 червня BYOK доступний у самому додатку Copilot у public preview на всіх платних планах, а з 14 липня — і в JetBrains-версії. Це означає, що Copilot можна залишити як оболонку, а інференс пустити через JoinGonka Gateway — за цінами децентралізованої мережі Gonka і без витрат premium-запитів підписки. У VS Code для BYOK не потрібні ні план Copilot, ні вхід в акаунт GitHub.

Що дає BYOK і коли він вам потрібен

Підписка Copilot обмежує premium-запити місячними лімітами: агентні сесії, рефакторинги та багатокрокові завдання з'їдають квоту швидше за все. BYOK виводить ці виклики на вашого провайдера: витрати тарифікуються за його цінами і не списують premium-квоту Copilot. Ключі зберігаються в системному keychain і не зчитуються інтерфейсом назад.

BYOK виправданий, якщо ви впираєтеся в ліміт, хочете моделі з відкритими вагами або платите за інференс кратно менше: мережа Gonka віддає ті ж open-source моделі в сотні разів дешевше за карткові ціни вендорів — актуальні ціни завжди в живому прайсі шлюзу.

Хронологія: що і коли включили

КолиЩо з'явилося
Листопад 2025BYOK у public preview: Anthropic, OpenAI, xAI, Microsoft Foundry; режими Agent, Plan, Ask, Edit у VS Code, JetBrains, Eclipse, Xcode
Січень 2026Підтримка будь-якого OpenAI-сумісного провайдера + AWS Bedrock і Google AI Studio; моделі з Responses API
23 червня 2026BYOK у додатку GitHub Copilot — public preview для всіх платних планів
18 червня 2026VS Code: BYOK працює без входу в GitHub і без плану Copilot; витрати йдуть у провайдера і не списують квоту запитів Copilot
14 липня 2026Custom OpenAI-сумісні endpoints у Copilot для JetBrains — на всіх тарифах

Підключення JoinGonka Gateway: покроково

Знадобиться ключ jg-… — його видають під час реєстрації на шлюзі разом із стартовими 3M безкоштовних токенів, картка не потрібна. Ключ і модель задаються в кожному клієнті Copilot окремо — нижче три шляхи.

VS Code — провайдер Custom Endpoint. Це актуальний шлях: колишній провайдер «OpenAI Compatible» і налаштування github.copilot.chat.customOAIModels оголошені застарілими.

КрокДія
1. Редактор моделейПалітра команд → Chat: Manage Language Models (або шестерня у списку моделей чату)
2. ПровайдерAdd Models → Custom Endpoint; назва групи — наприклад, JoinGonka
3. КлючВставте ваш jg-… — VS Code кладе його у власне захищене сховище, а не у файл
4. Тип APIChat Completions
5. МоделіVS Code відкриє chatLanguageModels.json — замініть масив "models" нової групи блоком нижче й збережіть файл
6. ВибірВиберіть модель у списку моделей чату; не з'явилася — перезапустіть VS Code
"models": [
  {
    "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "name": "DeepSeek V4 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 347232,
    "maxOutputTokens": 32768
  },
  {
    "id": "MiniMaxAI/MiniMax-M2.7",
    "name": "MiniMax M2.7 (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 191808,
    "maxOutputTokens": 8192
  },
  {
    "id": "zai-org/GLM-5.3-Flash",
    "name": "GLM 5.3 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 381808,
    "maxOutputTokens": 8192
  }
]

maxInputTokens — вікно контексту моделі за вирахуванням стелі відповіді: разом із maxOutputTokens воно й задає вікно. Без toolCalling: true модель не з'явиться у списку під час роботи з агентами.

Copilot CLI — лише змінні середовища. Файла налаштувань у провайдера немає, значення задаються в оболонці, з якої ви запускаєте copilot:

export COPILOT_PROVIDER_BASE_URL=https://gate.joingonka.ai/v1
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_PROVIDER_API_KEY=jg-your-key
export COPILOT_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=347232
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32768
copilot

Імена COPILOT_PROVIDER_* читає лише Copilot CLI, тому решти ваших інструментів налаштування не зачіпає. Від моделі CLI вимагає tool calling і streaming — це вміють усі моделі мережі.

JetBrains — плагін GitHub Copilot. Відкрийте Copilot Chat → список моделей → Manage Models, виберіть провайдера з OpenAI-сумісним endpoint, натисніть Add Models і введіть Base URL https://gate.joingonka.ai/v1, ключ jg-… та ідентифікатор моделі. Натисніть Save, позначте модель під своїм ключем і збережіть ще раз — вона з'явиться у списку поряд із вбудованими.

Підказка. Команда npx @joingonka/setup --tool copilot-byok надрукує всі три розділи вже з вашим ключем і реальними лімітами вибраної моделі — включно з готовим масивом "models" для VS Code — і живим запитом перевірить, що шлюз приймає ключ і модель. Файлів вона не пише: кожен клієнт Copilot зберігає ключ у власному сховищі.

Яку модель мережі обрати

Усі три моделі мережі підтримують streaming та tool calling. deepseek-ai/DeepSeek-V4-Flash-0731 — один із найдовших контекстів мережі (380K токенів) та найбільше виведення, до 32768 токенів: беріть її для великих репозиторіїв та довгих агентних сесій. MiniMaxAI/MiniMax-M2.7 — універсальна, виведення до 8192 токенів. zai-org/GLM-5.3-Flash — reasoning-модель Z.ai з найдовшим контекстом мережі (390K токенів): розмірковує перед відповіддю, виведення до 8192 токенів; частина бюджету відповіді йде на розмірковування, тому не занижуйте ліміт виведення в налаштуваннях.

Обмеження public preview — чесно

BYOK покриває агентні сесії та чат; inline-підказки та семантичний пошук за проектом залишаються на моделях Copilot і вимагають акаунта GitHub — це обмеження самого Copilot, а не провайдера. У Copilot Business та Enterprise локальний BYOK керується політикою адміністратора («Bring Your Own Language Model Key»): якщо пункту немає в інтерфейсі, він вимкнений на рівні організації. Vision-задачі через шлюз не працюють: моделі мережі текстові. Якщо інструмент надсилає запити у форматі Responses API — шлюз його приймає: POST /v1/responses, стрімінг і function tools працюють. Діалоги ми не зберігаємо, тому store ігнорується, а previous_response_id поверне помилку — передавайте історію цілком у input.

BYOK перетворює Copilot з підписки з лімітами на оболонку над вашим інференсом. У VS Code — Chat: Manage Language Models → Add Models → Custom Endpoint, у Copilot CLI — змінні COPILOT_PROVIDER_*, у JetBrains — Manage Models → Add Models; адреса gate.joingonka.ai/v1 і ключ jg- — і агентні сесії йдуть на моделях мережі Gonka за її реальними цінами, не зачіпаючи квоту запитів Copilot. Почніть з безкоштовних стартових токенів.

Бажаєте дізнатися більше?

Вивчіть інші розділи або почніть заробляти GNK прямо зараз.

Отримати безкоштовні токени →