LobeChat (LobeHub) com Claude e GPT via API personalizada

Sim. O LobeChat agora se chama LobeHub: o repositório lobehub/lobe-chat no GitHub redireciona para lobehub/lobehub, a documentação usa o novo nome e a imagem Docker é lobehub/lobehub. É um aplicativo de código aberto para chat e agentes que você pode usar na web, como aplicativo de desktop ou auto-hospedado. Cada agente escolhe um provedor e um modelo, então dá para usar o Claude numa tarefa e o GPT em outra.

Este guia segue a documentação do LobeHub e os rótulos da interface de outubro de 2026.

O LobeHub oferece três formas de apontar para a APIVAI:

A regra do /v1: URLs no formato OpenAI terminam em /v1; a da Anthropic não, porque o SDK da Anthropic acrescenta /v1/messages sozinho. O LobeHub também remove um /v1 no fim das URLs da Anthropic, mas o valor correto é https://api.apivai.com. Mais sobre os dois formatos: API compatível com OpenAI e proxy da API do Claude.

1. Crie uma conta com seu e-mail.
2. Adicione saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Você paga por token, sem assinatura.
3. Crie uma chave no Painel e copie. Defina um limite de orçamento se várias pessoas forem usá-la.

1. Abra App Settings → AI Providers.
2. Clique em Add Custom Provider. Abre a janela Create Custom AI Provider.
3. Preencha os campos da tabela abaixo e clique em Create.
4. Na página do novo provedor, use Connectivity Check: escolha um modelo e clique em Check. Deve aparecer Check passed.
5. Na lista de modelos, clique em Fetch models para carregar os IDs de /v1/models e ative os que quiser. Você também pode clicar em Add Model e digitar um Model ID manualmente.
6. Abra as configurações do seu agente e selecione o provedor APIVAI e um modelo.

Use Client Request Mode envia as requisições direto do navegador em vez de passar pelo servidor do LobeHub. Deixe desligado, a menos que tenha um motivo; se ligar e aparecerem erros de rede, desligue de novo.

Selecione Anthropic em AI Providers, ative, cole sua chave da APIVAI em API Key e coloque https://api.apivai.com em API Proxy URL. Rode o Check e ative os modelos Claude. O ID do modelo precisa bater com um ID da APIVAI, como claude-sonnet-4-6; se um cartão de modelo embutido usar outro ID, adicione o correto com Add Model. Se o Fetch models não retornar nada nesse modo, adicione os IDs manualmente. Um provedor próprio com Request Format Anthropic e a mesma URL funciona do mesmo jeito.

Selecione OpenAI, cole sua chave e defina API Proxy URL como https://api.apivai.com/v1. Deixe Use Responses API Specification desligado: o LobeHub descreve essa opção como suportada só por modelos da OpenAI, e você também vai mandar requisições do Claude por esse provedor.

Um servidor LobeHub auto-hospedado lê as configurações de provedores a partir de variáveis de ambiente. Adicione-as ao arquivo lobehub.env do guia de Docker, junto com as variáveis de banco de dados e autenticação que ele já exige:

Depois inicie o contêiner como de costume, por exemplo docker run -d -p 3210:3210 --env-file lobehub.env --name lobehub lobehub/lobehub, e reinicie-o após cada mudança no arquivo.

OPENAI_MODEL_LIST usa a sintaxe de lista de modelos do LobeHub: -all esconde os modelos OpenAI padrão, +id adiciona um modelo e id=Display Name renomeia. Uma chave definida assim é uma chave de servidor compartilhada por todos os usuários da sua instância, então dê a ela um orçamento próprio no Painel da APIVAI. A documentação do LobeHub observa que uma resposta vazia costuma significar que falta /v1 em OPENAI_PROXY_URL; com a APIVAI, inclua sempre.

O chat funciona totalmente pela APIVAI. Arquivos e base de conhecimento precisam, além disso, de um modelo de embeddings para indexar documentos, e a APIVAI não oferece embeddings.

Por padrão, o LobeHub gera embeddings com o text-embedding-3-small da OpenAI por meio do provedor OpenAI. Se você apontou OPENAI_PROXY_URL para a APIVAI, a indexação de arquivos vai falhar — mais um motivo para usar um provedor próprio no chat. Configure um provedor de embeddings separado com DEFAULT_FILES_CONFIG, por exemplo DEFAULT_FILES_CONFIG=embedding_model=ollama/<seu-modelo-de-embeddings>; o guia de base de conhecimento do LobeHub lista os provedores suportados. As respostas sobre seus arquivos continuam vindo do seu modelo de chat na APIVAI.

Preços por milhão de tokens em 2026-10-07. A lista muda com o tempo, então pegue os IDs em GET https://api.apivai.com/v1/models (ou no Fetch models) e na página de preços.

Uma configuração prática: Claude Haiku 4.5 ou GPT-6 Luna para um agente assistente geral, Claude Sonnet 4.6 para agentes de escrita e programação, e Claude Opus 5.5 só para o agente que cuida do trabalho mais difícil.

A APIVAI cobra por token a partir de um saldo pré-pago. Cada mensagem reenvia o histórico da conversa, então em chats longos cada mensagem custa mais.

Exemplo 1: uso pessoal diário. 50 mensagens por dia durante 30 dias, cada uma com cerca de 3.000 tokens de entrada e 800 de saída: 1.500 mensagens custam $10.94 no Claude Sonnet 4.6 ($31.50 nos preços oficiais), ou $0.157 no GPT-6 Luna.

Exemplo 2: trabalho com muitos documentos. Um agente que lê textos longos, 10 requisições por dia útil ao longo de 22 dias úteis, cada uma com cerca de 20.000 tokens de entrada e 1.500 de saída: 220 requisições custam $4.18 no Claude Sonnet 5.5, contra $12.10 nos preços oficiais.

O Painel mostra os tokens e o custo de cada requisição. A comparação de preços da API do Claude lista todos os modelos lado a lado com os preços oficiais.

• 401 ou "API key invalid": veja se a chave tem espaços sobrando, se não foi excluída, e confira o orçamento dela e o seu saldo no Painel.
• 404: a URL está com o /v1 errado. O formato OpenAI (provedor próprio, provedor OpenAI, OPENAI_PROXY_URL) precisa de https://api.apivai.com/v1; o formato Anthropic precisa de https://api.apivai.com. Nunca acrescente /chat/completions ou /messages.
• Modelo não encontrado: o Model ID precisa ser exatamente um ID da APIVAI, por exemplo claude-sonnet-4-6, e não um nome de exibição. Use Fetch models ou GET /v1/models.
• Respostas vazias ou cortadas: o raciocínio vem ativado por padrão e seus tokens contam como saída. Nas configurações de modelo do agente, ligue Enable Max Tokens Limit e defina Max Tokens Limit como 4096 ou mais. Se as respostas vierem vazias no formato OpenAI, confirme também que a URL termina em /v1.
• Variáveis de ambiente sem efeito: reinicie o contêiner depois de editar o lobehub.env e confira se os nomes das variáveis estão exatamente como acima.
• 429: o limite padrão é de 60 requisições por minuto por chave. Se uma instância compartilhada atingir o limite, peça ao suporte para aumentá-lo.

Sim. O LobeChat foi renomeado para LobeHub; o repositório, a documentação e a imagem Docker agora usam o nome LobeHub. As configurações que guias antigos descrevem para o LobeChat ficam em App Settings → AI Providers.

Sim, com um provedor próprio no formato OpenAI em https://api.apivai.com/v1. Uma chave da APIVAI funciona com todos os modelos da página de preços.

Não. O Docker só é necessário para rodar seu próprio servidor LobeHub. Em qualquer aplicativo do LobeHub que mostre AI Providers, você pode adicionar a APIVAI nas configurações como descrito acima.

A APIVAI não registra o conteúdo das requisições e respostas. Seu histórico é guardado pelo LobeHub — no seu próprio servidor, se você auto-hospedar.

Não. A APIVAI é pré-paga, com pagamento por uso, a partir de $10 e sem assinatura. Veja a documentação para outras ferramentas, ou o guia do Open WebUI para outra interface de chat auto-hospedada.

Crie uma conta, adicione saldo a partir de $10 e cole sua chave no LobeHub.