Pular para o conteúdo principal
O OpenCode é um agente de codificação de IA para o terminal. A Venice funciona através da configuração de provedor personalizado do OpenCode, usando o adaptador compatível com OpenAI e uma base URL customizada.

Provedor personalizado

Adicione a Venice como provedor em opencode.json

Compatível com OpenAI

Usa o endpoint /chat/completions da Venice

Chave via variável de ambiente

Lê sua chave de API a partir de VENICE_API_KEY

Pré-requisitos


Configuração

1

Defina sua chave de API Venice

Exporte sua chave de API Venice no shell em que você roda o OpenCode:
export VENICE_API_KEY="your-api-key"
2

Crie um arquivo de configuração do OpenCode

Para uma configuração específica de projeto, crie opencode.json na raiz do seu projeto.Para uma configuração global, use ~/.config/opencode/opencode.json em vez disso.
3

Adicione o provedor Venice

Cole esta configuração em opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "venice/zai-org-glm-5-1",
  "small_model": "venice/zai-org-glm-5-1",
  "provider": {
    "venice": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Venice AI",
      "options": {
        "baseURL": "https://api.venice.ai/api/v1",
        "apiKey": "{env:VENICE_API_KEY}"
      },
      "models": {
        "zai-org-glm-5-1": {
          "name": "GLM 5.1"
        },
        "kimi-k2-5": {
          "name": "Kimi K2.5"
        },
        "minimax-m25": {
          "name": "MiniMax M2.5"
        }
      }
    }
  }
}
4

Execute o OpenCode

Inicie o OpenCode a partir do mesmo diretório do projeto:
opencode
O OpenCode carregará opencode.json, usará VENICE_API_KEY e roteará o modelo Venice selecionado através de https://api.venice.ai/api/v1.

Verifique a configuração

Dentro do OpenCode, execute:
/models
Você deve ver os modelos Venice da sua configuração. Selecione um e envie um pequeno prompt de teste. Se definiu "model": "venice/zai-org-glm-5-1" como mostrado acima, o OpenCode deve usar esse modelo Venice por padrão. Você pode mudar o padrão substituindo zai-org-glm-5-1 por qualquer ID de modelo do catálogo de modelos de texto e adicionando-o ao mapa models.

Notas de configuração

  • Mantenha baseURL definido como https://api.venice.ai/api/v1. O adaptador compatível com OpenAI do OpenCode usa essa base URL para chat completions.
  • Mantenha npm definido como @ai-sdk/openai-compatible para o endpoint de chat compatível com OpenAI da Venice.
  • O ID do provedor é venice, então as referências de modelo usam o formato venice/<model-id>.
  • Se preferir o fluxo /connect do OpenCode, escolha Other, use venice como o ID do provedor, cole sua chave de API Venice e remova options.apiKey da configuração.
O OpenCode já suporta valores baseURL customizados de provedor e provedores compatíveis com OpenAI via @ai-sdk/openai-compatible. Nenhuma alteração no provedor core do OpenCode é necessária para a Venice.

Recursos

Modelos de texto Venice

IDs de modelos Venice disponíveis

Documentação de provedores do OpenCode

Referência de provedores personalizados e base URL