Seções da Base de Conhecimento ▾

Navegação

▸ Comece aqui Por funções

Categorias

Ferramentas 36
Glossário 12

copilot-byok.tag

GitHub Copilot BYOK: seus modelos em vez da cota

BYOK (bring your own key) é o mecanismo oficial do GitHub Copilot que permite conectar seu próprio provedor de modelos e trabalhar em sessões de agentes com ele, em vez de usar os modelos integrados GPT e Claude. Desde janeiro de 2026, qualquer endpoint compatível com OpenAI é suportado; desde 23 de junho, o BYOK está disponível no próprio aplicativo Copilot em public preview em todos os planos pagos, e desde 14 de julho, na versão para JetBrains. Isso significa que você pode manter o Copilot como interface e enviar a inferência através do JoinGonka Gateway — aos preços da rede descentralizada Gonka e sem gastar as premium-requests da sua assinatura.

O que o BYOK oferece e quando você precisa dele

A assinatura do Copilot limita as premium-requests mensais: sessões de agentes, refatorações e tarefas de múltiplos passos consomem a cota mais rapidamente. O BYOK redireciona essas chamadas para o seu provedor: o consumo é tarifado segundo os preços dele e não desconta a premium-quota do Copilot. As chaves são armazenadas no keychain do sistema e a interface não consegue lê-las de volta.

O BYOK é justificado se você atinge seu limite, deseja modelos com pesos abertos ou paga muito menos pela inferência: a rede Gonka oferece os mesmos modelos open-source centenas de vezes mais baratos que os preços dos vendedores — os preços atuais estão sempre na lista de preços em tempo real do gateway.

Cronologia: o que e quando foi incluído

QuandoO que surgiu
Novembro 2025BYOK em public preview: Anthropic, OpenAI, xAI, Microsoft Foundry; modos Agent, Plan, Ask, Edit no VS Code, JetBrains, Eclipse, Xcode
Janeiro 2026Suporte para qualquer provedor compatível com OpenAI + AWS Bedrock e Google AI Studio; modelos com Responses API
23 de junho 2026BYOK no aplicativo GitHub Copilot — public preview para todos os planos pagos
14 de julho 2026Custom OpenAI-compatible endpoints no Copilot para JetBrains (planos Pro e superiores)

Conexão do JoinGonka Gateway: passo a passo

Você precisará de uma chave jg-… — ela é emitida ao se registrar no gateway junto com 10M de tokens gratuitos iniciais; não é necessário cartão.

1. ConfiguraçõesAbra Settings → Model Providers (no VS Code — via Copilot Chat; no aplicativo Copilot — nas configurações de conta)
2. ProvedorAdicione um provedor do tipo «OpenAI compatible» com o endpoint https://gate.joingonka.ai/v1
3. ChaveInsira sua jg-… — ela será salva no keychain local
4. ModeloOs modelos da rede aparecerão no seletor ao lado dos embutidos; a lista atual é GET /v1/models: moonshotai/Kimi-K2.6, MiniMaxAI/MiniMax-M2.7, deepseek-ai/DeepSeek-V4-Flash-0731
5. SessãoEscolha o modelo para cada sessão — os modelos Copilot-hosted e BYOK podem ser alternados livremente

Dica: O comando npx @joingonka/setup --tool copilot-byok imprimirá os valores prontos para os campos abaixo (base URL, chave, id do modelo com limites atuais) e verificará com uma requisição ao vivo que o gateway os aceita. O Copilot é configurado apenas via UI — não existe um arquivo que possa ser editado com segurança, portanto, os valores devem ser inseridos manualmente.

Qual modelo de rede escolher

Todos os três modelos da rede suportam streaming e tool calling. deepseek-ai/DeepSeek-V4-Flash-0731 — o contexto mais longo da rede (380K tokens) e saída de até 32768 tokens: use-o para repositórios grandes e sessões de agentes prolongadas. moonshotai/Kimi-K2.6 — um poderoso modelo de agente para tarefas de múltiplos passos. MiniMaxAI/MiniMax-M2.7 — universal; Kimi e MiniMax têm saída de até 8192 tokens.

Limitações do public preview — com honestidade

O BYOK cobre sessões de agentes e chat; as inline-suggestions no editor podem continuar funcionando com modelos do Copilot — isso é uma limitação do próprio Copilot, não do provedor. A variante Enterprise do BYOK é configurada ao nível da organização e está disponível para GitHub Enterprise/Business. Tarefas de visão através do gateway não funcionam: os modelos da rede são textuais. Se a ferramenta envia requisições em formato Responses API, por enquanto não é compatível com o gateway; escolha Chat Completions.

O BYOK transforma o Copilot, de uma assinatura com limites, em uma interface sobre sua própria inferência: Settings → Model Providers → endpoint gate.joingonka.ai/v1 + chave jg- — e as sessões de agentes rodam nos modelos da rede Gonka a preços em tempo real, sem tocar na premium-quota. Comece com 10M de tokens gratuitos.

Quer saber mais?

Explore outras seções ou comece a ganhar GNK agora mesmo.

copilot-byok.cta.text →