Usar a IA da Zenifra no OpenCode
A IA da Zenifra é compatível com a OpenAI e funciona no OpenCode pelo plugin oficial zenifra/opencode-zenifra. O plugin traz os modelos do catálogo para o seletor do OpenCode e mantém a lista atualizada sozinho.
Pegar a chave
A chave vem do console da Zenifra:
- Plano de IA por membro: em Modelos de IA > Planos > Meu plano, na seção Conectar ferramentas. A chave começa com
zai_. Veja Planos de IA por membro. - IA por demanda: em Modelos de IA > Por demanda > Chaves de API. Veja Como começar com IA.
Trate a chave como uma senha: todo uso feito com ela conta no plano ou no crédito da organização.
Instalar o plugin
No terminal:
opencode plugin add github:zenifra/opencode-zenifraPara conferir a instalação:
opencode plugin listConectar a chave
No OpenCode, use a ação Connect an integration (atalho ctrl+a no seletor de modelos) ou o comando /connect, escolha Zenifra e cole a chave. O OpenCode guarda a chave, e ela não precisa ir para o arquivo de configuração.
Se preferir, use a variável de ambiente ZENIFRA_AI_API_KEY:
export ZENIFRA_AI_API_KEY="sua-chave"
opencode --standaloneSe o OpenCode roda como serviço, configure a variável no serviço:
opencode service set env ZENIFRA_AI_API_KEY "sua-chave"Se houver uma chave conectada pelo OpenCode, ela tem prioridade sobre a variável de ambiente.
Escolher o modelo
Abra o seletor com /models. Os modelos da Zenifra aparecem com o nome, por exemplo Qwen3.8 Flash, e o provedor Zenifra. A escolha vale para a sessão atual.
Para uma execução pelo terminal, use o ID do catálogo:
opencode run --model zenifra/qwen3.8-flash "Explique a estrutura deste projeto."Limites de uso
No plano de IA, a chave tem a janela de 5 horas e a semanal; veja como funcionam os limites. Na IA por demanda, valem as quotas da chave e o crédito da organização.
Quando um pedido não cabe no limite, a resposta diz o motivo e o que fazer, e o OpenCode mostra essa mensagem. Por exemplo:
The 5-hour usage limit of this key is used up. It resets at 2026-11-10 01:00 UTC.Outros clientes compatíveis com a OpenAI
Qualquer cliente compatível com a OpenAI funciona com três ajustes:
- URL base:
https://ai.zenifra.com/v1; - chave: a mesma do plano ou da IA por demanda;
- modelo: o ID do catálogo, como
zenifra/qwen3.8-flash.
Os IDs disponíveis estão no catálogo público https://ai.zenifra.com/v1/models.
Próximos passos
Última atualização em
Planos de IA por membro
Planos de IA com preço fixo por membro: Lite, Standard e Premium, chave de API própria, limites de 5 horas e semanal e cobrança proporcional ao ciclo.
Como começar com IA
Crie uma API key de IA na Zenifra, defina as quotas diária e mensal e os modelos permitidos, e faça sua primeira requisição OpenAI-compatible com Python.