OpenCode Zen

Zen é o serviço opcional de modelos com pagamento por uso do OpenCode. Você pode continuar com outros provedores. Um cliente gratuito não significa inferência gratuita.

Conectar e escolher modelo

1. Entre no console oficial (opens in a new tab), confira a cobrança e copie uma chave de API.
2. Na TUI, execute /connect, escolha OpenCode Zen e informe a chave. Não coloque credenciais no Git.
3. Escolha um modelo com /models, envie uma solicitação pequena sem dados sensíveis e confira o consumo.

Os identificadores usam opencode/<model-id>. Consulte o catálogo atual (opens in a new tab), sem adivinhar nomes. Para fixar a seleção, coloque o ID verificado em model na configuração.

Depois de conectar o Zen, esta configuração do projeto seleciona GPT 5.5. Você pode usar outro ID disponível na tabela.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}

Protocolos e APIs diretas

O prefixo é https://opencode.ai/zen/v1/. Cada modelo usa responses com o adaptador OpenAI, messages com Anthropic, chat/completions com o compatível ou endpoints próprios do Google. Siga a tabela de endpoints abaixo. A conexão integrada Zen faz essa associação; não envie todos os modelos ao mesmo endpoint Chat Completions.

Jev retorna decisões estruturadas, em vez de texto gerado, por https://opencode.ai/zen/v1/systemone. Os tipos de pergunta incluem noul, choice e score. Consulte o exemplo Jev abaixo para ID e formato atuais.

Lista de modelos e endpoints

As tabelas mostram IDs, endpoints e preços do Zen. Confirme a disponibilidade no catálogo atual: alguns modelos mantidos nas tabelas de referência já foram descontinuados. O prefixo opencode/ pertence à configuração do cliente; chamadas diretas à API usam o ID sem esse prefixo.

Jev

Defina OPENCODE_API_KEY no ambiente do terminal com sua chave do Zen. O exemplo pede uma decisão de urgência: noul é uma pergunta de sim/não, choice oferece opções nomeadas e score usa critérios de avaliação. O exemplo chama um modelo pago.

curl https://opencode.ai/zen/v1/systemone \
  -H "Authorization: Bearer $OPENCODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "My payments have failed for three days and I am losing sales. Please help now.",
    "questions": {
      "is_urgent": {
        "type": "noul",
        "instructions": "Does this request require urgent attention?"
      }
    }
  }'

Preços e controle de gastos

Confira entrada, saída, cache, contexto longo e processamento de pagamento na tabela de preços abaixo e no console. Ofertas gratuitas podem terminar e ter outras condições de dados. Verifique modelos descontinuados no catálogo atual. A geração de títulos de sessão também pode aparecer como uso de modelos menores.

A recarga automática cobra seu meio de pagamento quando o saldo fica abaixo do limite configurado. É possível mudar o valor ou desativar a função. Confira antes de executar um agente sem supervisão.

O limite mensal de uso controla consumo por espaço ou membro, não o total de pagamentos. Recargas podem cobrar mais que esse limite. Confira saldo, recarga e limites em conjunto.

Preços por token

Os preços são em dólares americanos por milhão de tokens. Entrada, saída, leitura e gravação de cache são cobradas separadamente; observe as faixas de contexto. Um traço não significa gratuidade. Imagens também podem gerar tokens cobrados, inclusive com DeepSeek V4 Flash Vision Exp.

Modelos gratuitos

Os modelos abaixo têm uma oferta gratuita. Disponibilidade e condições de dados variam; não há promessa de uso ilimitado ou gratuito para sempre. Jev retorna decisões estruturadas e não substitui um modelo de programação que gera texto.

• Big Pickle
• MiMo-V2.5 Free
• Ling 3.0 Flash Fin Free
• Nemotron 3 Ultra Free
• Nemotron 3.5 Lightning Free
• Muse Spark 1.3 Contributor Free
• Jev 1.13 Free

Exemplo de custo

No MiniMax M3, 100.000 tokens de entrada sem cache e 20.000 de saída custam 0,1 × $0.30 + 0,02 × $1.20 = $0.054, antes de outras cobranças. Novas tentativas e contexto repetido aumentam o consumo. A taxa de pagamento indicada é de 4,4% + $0.30 por transação; confira a cobrança no console.

Recarga automática

Se o seu saldo cair abaixo de $5, o Zen recarregará automaticamente $20.

Você pode alterar o valor da recarga automática. Também pode desativar a recarga automática por completo.

Limites mensais

Você também pode definir um limite mensal de uso para todo o workspace e para cada membro da sua equipe.

Por exemplo, digamos que você defina um limite mensal de uso de $20; o Zen não usará mais de $20 em um mês. Mas, se você tiver a recarga automática ativada, o Zen pode acabar cobrando mais de $20 se o seu saldo cair abaixo de $5.

Modelos descontinuados

Privacidade

Leia a seção atual por modelo (opens in a new tab). A fonte descreve hospedagem nos EUA e retenção com exceções; isso não garante retenção zero para todos.

As exceções incluem retenção nas APIs OpenAI e Anthropic, possível uso para melhoria em alguns modelos gratuitos, registros de teste NVIDIA e treinamento Muse Spark Contributor. O aviso de teste NVIDIA pede que não sejam enviados dados pessoais ou confidenciais. Verifique os termos e acordos com validade limitada.

Equipes e chaves próprias

Admin gerencia modelos, membros, chaves e cobrança; Member, apenas suas próprias chaves. Administradores podem limitar gastos e desativar modelos. Solicitar um modelo desativado retorna erro, sem provar que a chave é inválida. Um espaço temporariamente gratuito não garante gratuidade permanente.

Com sua própria chave OpenAI ou Anthropic, o provedor cobra esses tokens diretamente, não Zen. Confira a conta responsável antes de comparar uso ou alterar limites.

Papéis

Você pode convidar colegas de equipe para o seu workspace e atribuir papéis:

• Admin : Gerenciar modelos, membros, chaves de API e cobrança
• Member : Gerenciar apenas as próprias chaves de API

Admins também podem definir limites mensais de gastos para cada membro para manter os custos sob controle.

Acesso a modelos

Admins podem habilitar ou desabilitar modelos específicos para o workspace. Solicitações feitas a um modelo desabilitado retornarão um erro.

Isso é útil em casos nos quais você quer desabilitar o uso de um modelo que coleta dados.

Traga sua própria chave

Você pode usar suas próprias chaves de API da OpenAI ou Anthropic e ainda acessar outros modelos no Zen.

Quando você usa suas próprias chaves, os tokens são cobrados diretamente pelo provedor, não pelo Zen.

Por exemplo, sua organização pode já ter uma chave para OpenAI ou Anthropic e você quer usar essa em vez da que o Zen fornece.

Diagnóstico

Para 401/403, confira chave, espaço e acesso; para modelo ausente, ID e descontinuação; para limites, saldo e gastos. Veja rede e solução de problemas.

Guias relacionados

• Configurar provedores
• Escolher modelos
• Rede
• Solução de problemas

Fonte da documentação (MIT)