Providers

Conecte e gerencie seus provedores de modelos de IA

A seção Provedores permite que você use seus próprios tokens de API de LLM no Zaia Endless. Provedores disponíveis: OpenAI, Anthropic, Google AI, OpenRouter e xAI.

Abra Plataforma → Configurações → Provedores. O botão Configurar provedor adiciona uma chave.

---

Requisito do Console

Para adicionar um provedor próprio de LLM, o Console precisa ter pelo menos 10 slots.

Se o Console tiver menos de 10 slots, continue usando os modelos da Zaia e compre créditos extras de LLM na própria plataforma. Ao tentar salvar um provedor próprio, a mensagem é:

Seu Console precisa ter pelo menos 10 slots para adicionar um provedor próprio de LLM. Para continuar usando LLMs agora, compre créditos extras de LLM diretamente pela Zaia.

Para comprar créditos extras:

1. Volte ao Console.
2. Abra Créditos de LLM — no Faturamento, o botão Créditos de LLM; no overview, o card LLM Zaia com Gerenciar uso.
3. Em Adicionar créditos, informe o valor e o método de pagamento e clique em Comprar créditos.

Os Agentes seguem no provider Zaia. Veja Model Selection.

---

Status do provedor

A tabela mostra as colunas Nome do provedor, Token do provedor e Status.

Status	O que aparece
Saudável	A última geração com essa chave concluiu sem erro
Com falha	A última requisição falhou. A linha mostra o modelo pedido e o motivo do provedor

Quando ao menos um provedor está Com falha, o topo da lista exibe o banner Um provedor LLM do cliente está falhando, com o texto:

Um ou mais provedores falharam na última requisição. Recarregue créditos, troque a chave ou altere o modelo. O aviso some após uma geração bem-sucedida ou ao atualizar a chave.

Para agir:

1. Recarregue créditos no provedor externo, ou
2. Abra o provedor na lista, atualize o Token e salve (Atualizar), ou
3. Troque o modelo do Agente em Model Selection.

O banner e o status Com falha saem depois de uma geração bem-sucedida com essa chave, ou quando você atualiza o token.

O owner também recebe o e-mail Falha do provedor LLM externo. Destinatários extras ficam em Notificações.

---

🔹 OpenAI

Passos:

1. Crie ou faça login na sua conta OpenAI em OpenAI Platform.
2. Acesse a página de criação de chave.
3. Clique no botão + Create new secret key no canto superior direito.
4. Dê à sua chave um nome descritivo.
   1. Opcional → Selecione um projeto específico para restringir a chave.
5. Clique em Create secret key.
6. Copie sua chave, salve-a em um local seguro e adicione-a como um Provider na Zaia.

Nota

⚠️ Importante:
Copie a chave imediatamente. Essa é a única vez que você verá a chave secreta completa.

---

🔹 Anthropic (Claude)

Passos:

1. Crie ou faça login na sua conta em Claude Platform.
2. Clique no botão + Create key no canto superior direito.
3. Dê à sua chave um nome descritivo.
   1. Opcional → Selecione um workspace específico para restringir a chave.
4. Clique em Add.
5. Clique em Copy Key.
6. Copie sua chave, salve-a em um local seguro e adicione-a como um Provider na Zaia.

Nota

⚠️ Importante:
Copie a chave imediatamente. Essa é a única vez que você verá a chave secreta completa.

---

🔹 Google Gemini (Google AI Studio)

Passos:

1. Crie ou faça login na sua conta Google em Google AI Studio.
2. Clique em Get API Key na barra lateral inferior esquerda.
3. Clique no botão Create API key no canto superior direito.
4. Dê à sua chave um nome descritivo.
   1. Opcional → Selecione um projeto específico para restringir a chave.
5. Clique em Create API key.
6. Copie sua chave, salve-a em um local seguro e adicione-a como um Provider na Zaia.

Nota

💡 Observação:
O Google permite visualizar suas chaves existentes a qualquer momento no painel do AI Studio.

---

4. OpenRouter

Passos:

1. Crie ou faça login na sua conta OpenRouter em Open Router.
2. Clique em Get API Key.
3. Clique em Create.
4. Dê à sua chave um nome descritivo.
   1. Limite de crédito (opcional): configure um limite de gastos para essa chave.
   2. Reset limit every…: configure com que frequência os créditos são renovados.
   3. Expiration: defina uma data de expiração automática para a chave.
5. Clique em Create.
6. Copie sua chave, salve-a em um local seguro e adicione-a como um Provider na Zaia.

Nota

⚠️ Importante:
Copie a chave imediatamente. Essa é a única vez que você verá a chave secreta completa.

---

Como configurar seu provider dentro do Zaia Endless

Você pode configurar a chave pela página Provedores do workspace ou a partir da configuração do Agente.

Opção 1: Pela página Provedores

Passos:

1. Abra Plataforma → Configurações → Provedores.
2. Clique em Configurar provedor.

Opção 2: Pela página de um Agente

Passos:

1. Após fazer login, clique em Builder no menu principal à esquerda.
2. Selecione um agente existente ou clique para criar um novo.
3. Dentro da configuração do agente, localize a seção Provider.
4. Clique no botão para configurar um provedor.

Configure o Provider

Independentemente do caminho escolhido acima, os passos finais de configuração são os mesmos:

Passos:

1. Nome: dê ao seu provider um nome reconhecível.
2. Descrição (opcional): adicione uma breve descrição, se necessário.
3. Provedor: escolha o provider desejado na lista.
4. Token: informe o token/chave de API específico do provider.
5. Clique em Criar para salvar.

Depois de salvo, acompanhe o Status na mesma lista. Se a chave falhar, siga Status do provedor.