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.
Permissões necessárias
| Ação | Scope mínimo |
|---|---|
| Criar e administrar uma chave de IA | ai_key.create, ai_key.read, ai_key.update ou ai_key.delete conforme a ação |
| Visualizar uso e custos de uma chave | ai_usage.read em ai_key:<key-id> |
| Fazer inferência | Use a credencial de inferência da IA; ela é separada da API Key da organização |
owner tem acesso completo na sessão de usuário. assistant, member e API Keys precisam dos grants específicos.
Visão geral da oferta
O catálogo atual de modelos, com IDs no formato zenifra/<modelo>, janela de contexto, limite de saída, capacidades e preços em R$ por milhão de tokens, é público:
GET https://ai.zenifra.com/v1/modelsAlguns exemplos do catálogo atual:
| Modelo | Contexto | Entrada (R$/1M tokens) | Saída (R$/1M tokens) |
|---|---|---|---|
zenifra/qwen3.8-flash | 1.000.000 tokens | 0,60 | 2,00 |
zenifra/deepseek-v4-flash-0731 | 1.000.000 tokens | 2,20 | 6,60 |
zenifra/kimi-k2.7-code | 229.376 tokens | 4,70 | 19,40 |
zenifra/glm-5.2 | 1.048.576 tokens | 5,70 | 20,00 |
Alguns modelos têm preço off-peak ou faixas por quantidade de tokens de entrada; veja Preços de modelos de IA. Os modelos, preços e limites podem mudar. Consulte sempre o catálogo ou 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: ID do catálogo habilitado para essa chave, comozenifra/qwen3.8-flash
Guarde a chave em variável de ambiente:
export ZENIFRA_AI_API_KEY="sua-chave"Custos, tokens e budgets
O consumo de IA é pré-pago e cobrado por token sobre o crédito compartilhado da organização. Sem crédito utilizável, novas chamadas são bloqueadas. Cartões cadastrados e cobranças pendentes não ampliam a capacidade de uso de IA.
Novos usuários recebem R$30,00 em crédito promocional enquanto a promoção estiver disponível. Esse crédito também pode ser usado com IA.
Ao criar a chave no console, defina:
- um nome que identifique o ambiente, a equipe ou a integração
- os modelos permitidos
- quota diária e mensal em R$, se quiser limitar o gasto da chave
- limites de requisições (RPM) e tokens (TPM) por minuto da chave, até o limite compartilhado da organização
A quota da chave nunca aumenta o crédito disponível da organização. Isso reduz risco de consumo inesperado e facilita auditoria por chave.
Erros comuns
| Código | Possível causa | Como agir |
|---|---|---|
401 (invalid_api_key) | chave ausente, inválida ou desativada | revise ZENIFRA_AI_API_KEY e gere nova chave se necessário |
403 (insufficient_permissions) | a chave não tem permissão para o recurso solicitado | revise os modelos permitidos da chave |
404 (model_not_found) | modelo inexistente ou indisponível | use um ID do catálogo GET /v1/models |
429 (rate_limit_exceeded) | limite de requisições ou tokens por minuto excedido | aplique backoff e reduza concorrência |
429 (insufficient_quota) | a organização está sem crédito ou a chave atingiu sua quota | adicione crédito ou revise a quota da chave |
O que acompanhar no console
No console da Zenifra, você consegue acompanhar:
- total gasto, requisições, tokens e taxa de sucesso no período (1, 7 ou 30 dias)
- uso diário
- uso por modelo
- modelos disponíveis e seus preços
- chaves de API criadas, com gasto e quota
Como começar
Para liberar acesso, entre no console da Zenifra e abra Modelos de IA. Depois:
- clique em Criar Chave de API e informe o nome da chave
- selecione quais modelos essa chave pode acessar
- se quiser, defina quota diária e mensal para a chave
- copie a chave e use na sua aplicação; ela é exibida somente uma vez
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?
Consulte o catálogo público GET https://ai.zenifra.com/v1/models ou a aba Modelos Disponíveis no console. Use o campo id, como zenifra/qwen3.8-flash.
O consumo usa o crédito da conta?
Sim. A IA usa exclusivamente o crédito utilizável da organização. Quando ele se esgota, novas chamadas são bloqueadas; o uso de IA não continua com cartão nem cria crédito adicional para a organização.
Última atualização em