Skip to Content

Configuração do BotGem

BotGem  é um cliente desktop de IA multiplataforma (macOS, Windows, iOS, Android) que suporta provedores de API personalizados.

Pré-requisitos

Passos de configuração

Passo 1: Abrir Configurações

Inicie o BotGem e clique em Configurações na barra lateral esquerda.

Abrir configurações

Passo 2: Ir para Service Provider

Clique em Service Provider.

Service Provider

Passo 3: Clicar em + e selecionar protocolo

Clique em + e escolha um tipo de protocolo. OpenAI é recomendado:

ProtocoloSelecionarModelos suportados
OpenAI Chat (recomendado)OpenAIopenai/gpt-4.1, openai/gpt-4.1-mini, openai/gpt-5.4-mini, etc. (exemplos)
ClaudeClaudeSérie Claude
GeminiGeminiSérie Gemini

O BotGem não suporta o protocolo OpenAI Responses (/v1/responses). Este protocolo usa um campo input em vez de messages, e o BotGem suporta apenas o formato padrão Chat Completions.

Selecionar OpenAI

Passo 4: Preencher a configuração

API Server por protocolo:

ProtocoloAPI Server
OpenAI Chat (recomendado)https://api.ofox.ai
Claudehttps://api.ofox.ai/anthropic
Geminihttps://api.ofox.ai/gemini

Exemplo com OpenAI Chat:

CampoValor
Nameofox (ou qualquer nome)
API Serverhttps://api.ofox.ai
API KeySua chave de API OfoxAI
ModelsClique em Refresh ou digite manualmente, ex. gpt-4.1

Preencher configuração

O BotGem completa automaticamente https://api.ofox.ai como https://api.ofox.ai/v1/chat/completions. Com OpenAI Chat, todos os modelos estão acessíveis — ao digitar manualmente use o formato provedor/nome-modelo, ex. anthropic/claude-opus-4.5.

Passo 5: Verificar conexão e salvar

Clique em Verificar conexão. Quando aparecer “Conexão bem-sucedida!”, clique em Salvar.

Conexão bem-sucedida

Começar a usar

Após salvar, volte para a tela principal e clique em Iniciar chat. O nome do modelo atual é exibido na parte superior. Digite sua mensagem para começar.

Iniciar conversa

Solução de problemas

P: A verificação de conexão falha

  1. Verifique se o API Server está correto (ver tabela acima)
  2. Verifique se a chave de API foi copiada completamente do Console OfoxAI 
  3. Verifique sua conexão de rede

P: O modelo desejado não está na lista

Clique em Refresh para a lista automática (sem prefixo, ex. gpt-4.1). Para outros modelos, digite o nome completo provedor/nome-modelo, ex.:

ModeloNome a digitar
DeepSeek V3deepseek/deepseek-v3.2
Claude Sonnetanthropic/claude-sonnet-4.6
Gemini Flashgoogle/gemini-3.1-flash-lite-preview

Lista completa em Modelos .

Last updated on