IA

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-zenifra

Para conferir a instalação:

opencode plugin list

Conectar 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 --standalone

Se 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

Nessa página