Chatbox AI
Instale o Chatbox AI, adicione um provedor personalizado do RunAPI, busque um modelo, execute a verificação de conexão e confirme um chat.
Conecte o Chatbox AI ao RunAPI com um provedor BYOK personalizado. Os nomes abaixo seguem a interface atual de provedor personalizado; os rótulos podem variar ligeiramente entre versões desktop. Crie uma Chave de API padrão do RunAPI no Guia de Autenticação antes de continuar.
Instalar Chatbox AI
Baixe o Chatbox AI na sua página oficial de download ou nas versões oficiais, depois abra Settings.
Adicionar o provedor RunAPI
- Abra AI Provider / Model Settings e selecione Add Provider.
- Nomeie como
RunAPIe escolha OpenAI API Compatible como modo de API (API Mode). - Insira sua Chave de API do RunAPI.
- Defina API Host como
https://runapi.ai/v1e API Path como/chat/completions. - Confirme que a prévia da URL termina em
https://runapi.ai/v1/chat/completionse salve.
Mantenha o Host e o Path separados. O Fetch constrói a descoberta de modelos a partir
do Host com /models, enquanto o chat usa o Host mais o Path de API configurado.
Adicionar e verificar um modelo
Selecione Buscar para carregar o inventário de modelos do RunAPI. Se a descoberta não estiver disponível, selecione Novo e insira um identificador exato do Catálogo de Modelos. O Chatbox AI precisa de pelo menos um modelo salvo antes que Verificar possa ser executado.
Selecione Verificar, escolha o modelo salvo e execute o teste de conexão. Trate uma Requisição de Texto bem-sucedida como o sinal de referência. Requisição de Visão e Requisição de Uso de Ferramenta dependem das capacidades do modelo selecionado e podem falhar independentemente sem invalidar o chat de texto básico.
Verificar a conexão
Inicie um novo chat, escolha o modelo RunAPI salvo no seletor de modelos,
e envie Reply with the word connected. Uma resposta normal confirma que
o provedor personalizado está ativo.
Solucionar problemas
- A pré-visualização da URL está errada: use Host
https://runapi.ai/v1e Path/chat/completions; não coloque a URL completa da operação em ambos os campos. - O Check está desabilitado ou não tem modelo: use Fetch ou New para adicionar ao menos um modelo primeiro.
- Text Request falha com erro de autenticação: atualize o provider com uma chave padrão válida do Guia de Autenticação.
- Text funciona, mas Vision ou Tool Use falha: escolha um modelo que declare a capacidade necessária no Catálogo de Modelos; essas verificações não são requisitos universais do provider.
Para o comportamento de protocolo compartilhado, use o Início rápido da API LLM. Para campos de requisição e resposta, use a Referência da API Chat Completions.