Como começar com IA na Zenifra
Este guia mostra como gerar sua credencial, limitar o uso com budget e fazer a primeira chamada usando um cliente OpenAI-compatible.
Pré-requisitos
- uma conta na Zenifra
- acesso ao console da Zenifra
- saldo disponível ou os R$30,00 recebidos ao criar a conta
- um projeto Python com o pacote
openaiinstalado - uma variável de ambiente para guardar a chave
Passo 1: Criar a API key
No console da Zenifra, abra Modelos IA e clique em Criar Chave de API.
Essa chave será usada pela sua aplicação para autenticar chamadas ao endpoint https://ai.zenifra.com/v1. Guarde essa credencial como qualquer outro segredo de produção.
Passo 2: Definir budget e modelos permitidos
Ao criar a chave, defina um budget de custo e selecione os modelos que ela poderá acessar.
Esse fluxo é útil para separar uso por ambiente, equipe ou integração.
Passo 3: Fazer a primeira requisição
Instale o SDK da OpenAI no seu projeto Python:
pip install openaiDepois, use o exemplo abaixo. Para esta documentação, vamos usar o modelo zenifra/qwen3.6-35b-a3b, se ele estiver habilitado para a sua chave no console:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://ai.zenifra.com/v1",
api_key=os.environ["ZENIFRA_AI_API_KEY"],
)
response = client.chat.completions.create(
model="zenifra/qwen3.6-35b-a3b",
messages=[
{
"role": "user",
"content": "Qual é a média de temperatura na região sul do Brasil?",
}
],
)
print(response.choices[0].message.content)Passo 4: Acompanhar uso e custos
No console, você consegue visualizar:
- custos diários
- custos totais
- uso por modelo
- modelos atuais
- chaves criadas
Como funciona a cobrança
O uso de IA é cobrado por tokens. Os preços e modelos disponíveis podem mudar ao longo do tempo, então consulte sempre o console antes de publicar integrações em produção.
O consumo segue o ciclo de renovação da conta do usuário. Se houver saldo disponível, ele será utilizado primeiro. Se não houver saldo suficiente, o valor pendente ficará como saldo negativo.
Os R$30,00 recebidos ao criar a conta também podem ser usados com a oferta de IA.
FAQ
Preciso usar o SDK da OpenAI?
Não obrigatoriamente. O importante é usar um cliente compatível com a API da OpenAI e configurar base_url e api_key corretamente.
Onde acompanho os modelos e preços atuais?
No console, na área de Modelos IA.
Posso limitar o uso de uma chave?
Sim. O fluxo de criação da chave permite definir um budget de custo e selecionar quais modelos ela pode acessar.