IA na Zenifra
A Zenifra oferece modelos de IA com integração simples, cobrança por uso e acompanhamento direto no console. A API é compatível com clientes OpenAI-compatible que permitem configurar base_url, api_key e model.
Visão geral da oferta
A oferta atual inclui modelos como zenifra/qwen3.6-35b-a3b e zenifra/qwen2.5-7b. O modelo zenifra/qwen3.6-35b-a3b oferece contexto de 262.144 tokens.
| Modelo | Contexto | Melhor para | Velocidade média | Preço |
|---|---|---|---|---|
zenifra/qwen3.6-35b-a3b | 262.144 tokens | respostas longas, análise de documentos e tarefas complexas | consultar no console | consultar no console |
zenifra/qwen2.5-7b | consultar no console | tarefas rápidas, chat e automações internas | consultar no console | consultar no console |
Os modelos, preços e métricas podem mudar. Consulte sempre o console antes de publicar uma integração em produção.
Como integrar
Se você já usa o SDK oficial da OpenAI, a integração normalmente muda apenas três pontos:
base_url:https://ai.zenifra.com/v1api_key: chave criada no console da Zeniframodel: modelo habilitado para essa chave
Guarde a chave em variável de ambiente:
export ZENIFRA_AI_API_KEY="sua-chave"Custos, tokens e budgets
O consumo de IA é cobrado por token. O saldo disponível na conta é usado primeiro; se ele não for suficiente, o restante pode ficar como saldo negativo conforme a regra de cobrança da conta.
Ao criar a chave no console, defina:
- budget de custo
- modelos permitidos
- separação por ambiente, equipe ou integração
Isso reduz risco de consumo inesperado e facilita auditoria por chave.
Erros comuns
| Código | Possível causa | Como agir |
|---|---|---|
401 | chave ausente, inválida ou revogada | revise ZENIFRA_AI_API_KEY e gere nova chave se necessário |
403 | modelo não permitido para a chave | edite permissões da chave ou use um modelo habilitado |
429 | limite de uso ou frequência excedido | aplique backoff e reduza concorrência |
| budget excedido | chave atingiu o orçamento configurado | aumente o budget ou use outra chave autorizada |
O que acompanhar no console
No console da Zenifra, você consegue acompanhar:
- custos diários
- custos totais
- uso por modelo
- modelos atualmente disponíveis
- chaves de API criadas
- velocidade média exibida para modelos quando disponível
Como começar
Para liberar acesso, entre no console da Zenifra e abra Modelos IA. Depois:
- clique em Criar Chave de API
- defina um budget de custo para a chave
- selecione quais modelos essa chave pode acessar
- copie a chave e use na sua aplicação
O passo a passo completo está em Como começar com IA.
Próximos passos
FAQ
A API é compatível com OpenAI?
Sim. A oferta atual é OpenAI-compatible e pode ser usada com clientes que permitam configurar base_url e api_key.
Onde vejo o nome exato do modelo?
Veja os modelos e as condições atuais diretamente no console. Ao integrar, troque model="<modelo>" pelo nome exibido para sua chave.
O consumo usa saldo da conta?
Sim. O saldo disponível é consumido primeiro. Se ele não cobrir todo o uso, o restante fica como saldo negativo.