OpenCode AI Gateway: Conecte Múltiplos LLMs Através de Uma API

Um gateway OpenCode AI oferece uma camada de API estável entre o seu fluxo de trabalho no terminal e os modelos que você realmente deseja usar. Se você está lidando com chaves de provedores separadas, páginas de cobrança separadas e riscos de disponibilidade separados, essa camada extra pode tornar o OpenCode muito mais fácil de operar no dia a dia.

ShareAI se encaixa bem nesse papel porque oferece uma API para mais de 150 modelos, além de roteamento inteligente, failover e visibilidade de marketplace. OpenCode já suporta provedores personalizados compatíveis com OpenAI, então a configuração é basicamente apontar o OpenCode para o URL base correto e adicionar o modelo que você deseja usar.

Este guia faz parte de nossos Desenvolvedores artigos sobre roteamento de IA, acesso a modelos e integrações prontas para produção.

Por que usar um gateway OpenCode AI em primeiro lugar?

OpenCode foi projetado para funcionar com muitos provedores, e sua documentação pública mostra suporte para configuração de provedores personalizados, valores baseURL.

• e endpoints compatíveis com OpenAI. Essa flexibilidade é poderosa, mas também significa que você pode acabar gerenciando cada provedor separadamente quando tudo o que você realmente deseja é um fluxo de trabalho de codificação limpo.
• Uma chave de API em vez de uma chave por fornecedor de modelo.
• Uma superfície de cobrança em vez de vários painéis.
• Alternância mais limpa entre modelos para edições rápidas, tarefas de contexto longo ou refatorações mais pesadas.

Uma camada de roteamento que pode ajudar quando um provedor está lento, indisponível ou não é mais o mais adequado para o trabalho.

Para desenvolvedores que desejam flexibilidade sem manter a infraestrutura separada de provedores, esse é geralmente o ponto em que um gateway de IA começa a valer a pena.

Como o OpenCode suporta essa configuração Documentação do provedor OpenCode, você pode personalizar as configurações do provedor através opencode.json, definir um personalizado valores, e usar @ai-sdk/openai-compatible para provedores compatíveis com OpenAI. O público repositório GitHub do OpenCode também documenta seus caminhos de configuração e confirma que a ferramenta foi projetada para flexibilidade no nível do provedor.

Isso significa que você não precisa de um pacote especial de integração ShareAI para começar. Você pode adicionar o ShareAI como um provedor personalizado, manter sua chave de API em uma variável de ambiente e então escolher o modelo exato que deseja que o OpenCode utilize.

Passo 1: Crie sua chave de API ShareAI e escolha um modelo

Comece gerando credenciais em Crie uma Chave de API. Em seguida, navegue pelo marketplace de modelos do ShareAI para decidir qual modelo deve suportar seu fluxo de trabalho OpenCode.

Um padrão prático é escolher um modelo padrão para tarefas de codificação diárias e manter uma ou duas alternativas em mente para casos onde você deseja menor latência, menor custo ou um modelo de raciocínio mais forte.

Etapa 2: Adicione o ShareAI como um provedor personalizado no opencode.json

OpenCode permite que você defina um provedor personalizado com um endpoint compatível com OpenAI. Um modelo inicial simples se parece com este:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "shareai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ShareAI",
      "options": {
        "baseURL": "https://api.shareai.now/v1",
        "apiKey": "{env:SHAREAI_API_KEY}"
      },
      "models": {
        "your-shareai-model": {
          "name": "Choose a ShareAI model"
        }
      }
    }
  }
}

Substituir seu-modelo-shareai com o identificador exato do modelo que você deseja usar do catálogo de modelos ShareAI. Mantenha a chave da API fora do arquivo e carregue-a por meio de uma variável de ambiente.

export SHAREAI_API_KEY="sua_chave_api_aqui"

Se você quiser o formato de solicitação mais amplo e os detalhes de autenticação, o Referência da API cobre o fluxo principal da API ShareAI.

Etapa 3: Alterne modelos sem reconstruir sua configuração

Uma vez que o ShareAI é a camada de provedor, as mudanças de modelo tornam-se muito mais leves. Você não está mais refazendo a autenticação do fornecedor toda vez que deseja testar um modelo diferente. Em vez disso, você mantém a mesma superfície da API e altera o modelo para o qual o OpenCode aponta.

Isso é especialmente útil quando seu fluxo de trabalho de codificação muda por tarefa. Você pode querer um modelo para edições rápidas, outro para raciocínio em repositórios maiores e um terceiro como alternativa quando o custo ou a latência forem mais importantes do que a capacidade máxima. Você pode comparar opções no marketplace de modelo transparente e verificar o comportamento no Playground antes de definir um padrão.

Quando chaves diretas de provedor ainda fazem sentido

Ainda há casos em que ir direto é razoável. Se você depende de um recurso beta específico do provedor, um acordo empresarial privado ou uma configuração rigorosa de governança no provedor, pode querer manter esse caminho separado.

Mas para equipes que principalmente desejam que o OpenCode permaneça flexível, portátil e mais fácil de operar, usar um gateway de IA OpenCode é frequentemente a opção padrão mais limpa. Isso reduz a dispersão de contas e permite avaliar modelos com base no desempenho e adequação, em vez de qual login de fornecedor você configurou por último.

Conclusão final

Um gateway de IA OpenCode não se trata de adicionar mais ferramentas por si só. Trata-se de manter um fluxo de trabalho de codificação enquanto se dá espaço para mudar modelos, comparar fornecedores e continuar avançando quando o cenário de modelos subjacente muda. Se isso é o que você deseja do OpenCode, o ShareAI oferece uma maneira prática de fazer isso através de uma API.