Rode o LobeChat em um endpoint compatível com OpenAI personalizado.

Resposta rápida: um provider personalizado, um endpoint, uma chave.

Abra as configurações do LobeChat e vá para a seção de provider de serviço de IA (rotulada AI Service Provider ou Language Model dependendo da versão). Como o módulo de gerenciamento de provider chegou na v1.44, você pode criar um provider personalizado em vez de aproveitar a entrada nativa do OpenAI: adicione um provider, dê a ele um id e um nome de exibição (apisrouter / APIsRouter), escolha o tipo de SDK OpenAI, depois preencha a chave de API e a URL de proxy do endpoint com https://api.apisrouter.com/v1. Na lista de modelos do provider, use a ação de buscar modelos para puxar cada id que o endpoint serve por /v1/models, habilite os que você quer, e rode a verificação de conectividade nativa. A partir daí, qualquer assistente ou conversa pode selecionar esses ids no seletor de modelo. O projeto agora vive em lobehub/lobehub no GitHub (o repositório lobe-chat redireciona para lá), e os rótulos de menu mudam entre versões, então trate o fluxo, entrada de provider, tipo de SDK, URL, chave, busca, como a parte estável em vez do texto exato.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → habilite os ids → verifique

Como o LobeChat roteia requisições para um provider.

O LobeChat (cerca de 80 mil estrelas no GitHub, agora sob o nome LobeHub) é um dos frameworks de chat de código aberto mais implantados: um cliente web polido, assistentes com seus próprios prompts e modelos, um sistema de plugins, e recursos de base de conhecimento, implantável em uma sessão de navegador ou auto-hospedado com um banco de dados. Cada entrada de provider descreve para onde as requisições vão e qual dialeto de SDK falar. Um provider personalizado no tipo de SDK OpenAI envia requisições padrão de chat-completions para sua proxy URL com o id de modelo como uma string simples, que é exatamente o formato que um gateway multi-fornecedor espera. Uma entrada, portanto, carrega o catálogo inteiro: assistentes podem fixar claude-sonnet-4-6 para trabalho cuidadoso enquanto conversas rápidas rodam gemini-3.5-flash, sem uma segunda conta em lugar nenhum. A URL do endpoint tem uma nuance documentada que vale a pena citar: se a URL precisa de um sufixo /v1 depende do serviço por trás dela. O LobeChat anexa caminhos de rota como /chat/completions à base que você fornece, então para a APIsRouter o valor correto é https://api.apisrouter.com/v1. O sintoma documentado de um sufixo ausente é o modelo retornando uma resposta vazia no teste; se você ver isso, adicione /v1 e tente de novo.

Auto-hospedagem: o caminho por variável de ambiente.

Se você implanta o LobeChat você mesmo, o mesmo roteamento pode vir embutido no container em vez de clicado na UI. O par clássico sobrescreve o provider OpenAI nativo: OPENAI_API_KEY recebe a chave do gateway e OPENAI_PROXY_URL recebe https://api.apisrouter.com/v1. Todo usuário dessa implantação então herda o endpoint sem tocar nas configurações. A visibilidade de modelo é controlada com a sintaxe de lista de modelos: OPENAI_MODEL_LIST aceita +id para adicionar, -id para esconder, e id=Nome de Exibição para renomear, com entradas separadas por vírgula. Começar o valor com -all limpa a lista nativa para que só seus ids explícitos apareçam, que é o formato limpo para uma implantação curada. Builds de servidor mais recentes também documentam uma família CUSTOM_PROVIDER_* (contagem, id, nome, tipo, URL base, chaves) para declarar providers personalizados completos no momento do deploy, espelhando o que o módulo de UI faz. Verifique a referência atual de variáveis de ambiente para sua versão antes de confiar nisso, já que essa superfície é mais nova que o par OPENAI_* e ainda está evoluindo.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

Escolhendo modelos para assistentes.

Como todos os assistentes são cobrados por uma chave, a comparação de modelo é uma mudança nas configurações do assistente. Fixe dois candidatos em dois assistentes duplicados, rode seus prompts reais por uma semana, e leia o gasto por modelo no console da APIsRouter ao lado da qualidade de resposta que você observou.

• Assistentes são modelos fixados por papel. Um assistente de escrita em claude-sonnet-4-6, um assistente de resposta rápida em claude-haiku-4-5-20251001, e um assistente de pesquisa em gpt-5.5 coexistem atrás de uma entrada de provider.
• gemini-3.5-flash é a escolha de responsividade para o modelo padrão de conversa; a maioria dos turnos em um framework de chat são curtos e modelos rápidos mantêm a UI parecendo instantânea.
• deepseek-v4-pro ganha um lugar para conversas longas multilíngues e resumo pesado, onde seu comportamento de contexto longo por token gasto é o atrativo.
• Conversas com visão precisam de um id capaz de visão com a capacidade habilitada na configuração de modelo do provider; o LobeChat expõe toggles de capacidade por modelo no módulo de provider.
• Habilite um seletor de dois níveis deliberadamente, um id rápido e um id de ponta, e adicione mais só quando um assistente real precisar deles; todo modelo habilitado é uma linha que os usuários rolam.

Pague pelo uso · abaixo do preço oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de falha específicos do LobeChat.

Uma resposta vazia na verificação de conectividade é a assinatura documentada de um problema de sufixo na base URL. Adicione ou remova o /v1 (para a APIsRouter ele precisa estar presente) e tente de novo antes de depurar qualquer coisa mais profunda. Modelos ausentes do seletor de um assistente geralmente significa que foram buscados mas não habilitados na lista de modelos do provider, ou o próprio toggle do provider está desligado. Ambos vivem na mesma tela de configurações que a ação de busca. Em implantações auto-hospedadas, lembre-se da precedência: variáveis de ambiente configuram os padrões do lado do servidor, enquanto usuários ainda podem inserir suas próprias configurações de provider do lado do cliente dependendo da autenticação e das flags de recurso da sua implantação. Se uma implantação ignora seu OPENAI_PROXY_URL, confirme que o container de fato reiniciou com o novo ambiente e que a sessão do cliente não está sobrescrevendo isso localmente. A deriva de versão é real aqui: a árvore de configurações foi reorganizada mais de uma vez (Language Model, depois AI Service Provider, com o módulo de provider chegando na v1.44), e screenshots de tutoriais antigos não vão corresponder aos menus atuais. Os campos em si, id, nome, tipo de SDK, URL, chave, permaneceram estáveis.

Quem roteia o LobeChat por um gateway.

• Auto-hospedeiros rodando o LobeChat para um time que querem um endpoint no container e um log de uso para todos, em vez de chaves de fornecedor por usuário.
• Power users de assistente que fixam fornecedores diferentes por papel, Claude para escrita, GPT para análise, DeepSeek para volume, sem manter contas para cada um.
• Usuários que querem modelos que a lista nativa de provider não carrega, habilitados ao buscar o catálogo do gateway em vez de esperar releases upstream.
• Desenvolvedores sem acesso ao faturamento de um determinado fornecedor. O acesso baseado em recarga sem exigência de cartão remove a dependência de cadastro por provedor.
• Pessoas que já roteiam seu editor, launcher, ou ferramentas de CLI por um gateway e querem seu framework de chat na mesma chave.

Verifique o endpoint e depure a primeira conversa.

Faça curl na listagem de modelos primeiro e mantenha a saída aberta; ela é a grafia autoritativa para todo id que você habilitar, seja por busca ou manualmente. Depois rode uma chat completion contra o id que você planeja tornar padrão. Dentro do LobeChat, trabalhe a verificação de conectividade antes de conversas reais. Falhas de autenticação apontam para o campo de chave. Uma resposta vazia aponta para o sufixo /v1. Erros de não encontrado em um modelo específico significam que o id habilitado não corresponde à listagem, o que acontece principalmente depois de editar à mão nomes de exibição e ids juntos. Assim que as conversas fluem, o console da APIsRouter mostra modelo, contagens de token e gasto por requisição. Um framework de chat com assistentes gera tráfego em vários modelos ao mesmo tempo, e a visão de uso por chave é onde o hábito de cada assistente vira um custo que você consegue ver por modelo, por dia.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Perguntas frequentes