Skip to main content
O provider é a empresa que roda o modelo de IA e cobra por token. O agente da Zatten aceita dois: OpenAI e OpenRouter. A chave é sempre da agência (ou do cliente final), e a conta da IA vai direto ao provider. A Zatten não cobra nada sobre a IA. Isso é o BYOK (bring your own key).

​
OpenAI ou OpenRouter?

Quando usar cada um:
  • OpenAI quando o projeto vai usar só GPT e a agência quer a conta direto na OpenAI.
  • OpenRouter quando quer comparar modelos de fabricantes diferentes, usar Gemini ou Claude, ou ter um modelo de reserva de outro fabricante com a mesma chave (Resiliência).
Os dois funcionam igual dentro da Zatten: retry, fallback, tools e transcrição valem para ambos. Preços nunca são copiados aqui: veja nos links do fim da página.

​
Criar a chave e colocar créditos

1

Crie a conta

Entre em https://platform.openai.com com o e-mail da agência ou do cliente final (quem vai pagar).
2

Coloque créditos

Em Settings → Billing, adicione um cartão e compre créditos. Sem saldo, toda chamada falha. Ligue a recarga automática se não quiser que o agente pare quando o saldo acabar.
3

Crie a chave

Em API keys (https://platform.openai.com/api-keys), clique em Create new secret key. Copie na hora: a chave aparece uma vez só.
Uma chave por cliente final. Assim dá para ver o gasto de cada um no painel do provider, pôr limite e revogar uma chave sem derrubar os outros projetos. Na OpenAI, use um projeto (Projects) por cliente final, com a chave dentro dele. No OpenRouter, uma chave por cliente com limite de crédito.

​
Configurar no agente

1

Abra as configurações do modelo

Em Agente, clique no ícone de ajustes ao lado do modelo. Abre Configurações do modelo.
2

Escolha o provider e cole a chave

Em Provider, escolha OpenAI ou OpenRouter. Em API Key, cole a chave do mesmo provider.
3

Escolha o modelo

A lista de modelos muda com o provider. Ver Escolher o modelo.
4

Salve, teste e publique

Salvar cria um rascunho. Teste no chat do builder e clique em Publicar.
A mesma chave serve, sem configurar de novo, para:
  • os modelos de fallback do mesmo provider (fallback de outro provider exige a chave dele);
  • a transcrição de áudio;
  • o resumo de conversas longas e o seletor de tools, quando usam outro modelo.

​
BYOK: quem é dono da chave?

Duas formas comuns:
  • Chave da agência. A agência paga o provider e repassa no preço ao cliente final. Mais simples de operar; o custo de IA entra na conta da agência. Ver Quanto cobrar do cliente final.
  • Chave do cliente final. O cliente cria a conta no provider e passa a chave. O gasto fica com ele; a agência depende dele manter o saldo.
Nos dois casos, a conta é por token, direto ao provider. Para estimar quanto vai custar, ver Estimar o custo de IA.
No OpenRouter, “BYOK” quer dizer outra coisa: usar a sua chave de um fabricante (por exemplo, OpenAI) dentro do OpenRouter. Não é necessário para usar o OpenRouter na Zatten.

​
Pelo MCP

  • langchain.config.model.provider (openai ou openrouter) e model.api_key.
  • Numa escrita do bloco langchain, a chave já gravada é mantida só quando o campo api_key não vem. Para trocar de chave, envie a nova. Nunca envie "": o vazio é gravado e o agente para de responder.
  • O get_template devolve a chave preenchida. Nunca mostre a chave na conversa nem a grave em arquivo; o snapshot troca a chave por "<removido>" (Regras).

​
Armadilhas

  • Chave de um provider no outro: a chave da OpenAI começa com sk-, a do OpenRouter com sk-or-. Trocada, toda mensagem falha com 401.
  • Sem saldo: a OpenAI responde 429 (insufficient_quota) e o OpenRouter 402. O agente tenta de novo e, sem um fallback com saldo, cai na mensagem de erro. Ligue a recarga automática.
  • A lista de modelos da OpenAI é geral. Um modelo pode aparecer e a sua chave não ter acesso a ele. Teste no chat do builder antes de publicar.
  • Trocar de provider muda o nome do modelo. gpt-5-mini na OpenAI é openai/gpt-5-mini no OpenRouter.
  • Max tokens alto no OpenRouter reserva mais crédito por chamada. Com saldo baixo, a chamada pode ser recusada mesmo que a resposta fosse curta.

​
Perguntas frequentes

Não. A IA é paga direto ao provider, por token. O plano da Zatten é cobrado à parte (Planos, limites e cobrança).
Não direto. Use pelo OpenRouter, que dá acesso a esses modelos com uma chave só.
O OpenRouter cobra uma taxa na compra de créditos e repassa o preço por token do fabricante sem acréscimo (FAQ do OpenRouter, consultado em 06/10/2026). Confira o valor atual da taxa em https://openrouter.ai/docs/faq.
No painel do provider (uso por chave), e em Métricas na Zatten (tokens por dia). Com o LangSmith, por conversa.

​
Vídeo

O vídeo pode mostrar uma versão anterior da tela. Quando houver diferença, vale o texto desta página.

​
Para saber mais

Termos para buscar: “OpenAI API key create”, “OpenAI prepaid billing credits”, “OpenAI projects API keys”, “OpenRouter credits”, “OpenRouter API key credit limit”, “insufficient_quota 429”.