Pular para o conteúdo
Recursos para Desenvolvedores
Recursos para Desenvolvedores

NextChat

Conecte o NextChat ao RunAPI com um endpoint e modelo personalizados.

Ver Markdown

Conecte o NextChat ao RunAPI por meio de seu endpoint OpenAI personalizado. O NextChat compõe o caminho de operação de forma diferente dos outros clientes neste grupo, portanto use o valor exato de endpoint indicado abaixo. Crie uma Chave de API padrão do RunAPI no Guia de Autenticação antes de continuar.

Instalar ou implantar NextChat

Escolha uma versão desktop ou método de implantação no repositório oficial do NextChat e abra Settings (Configurações).

Configurar o endpoint personalizado

  1. No aplicativo Web, habilite Custom Endpoint e selecione OpenAI. O aplicativo desktop sempre usa configuração personalizada.
  2. Defina o endereço do endpoint como https://runapi.ai sem /v1.
  3. Insira sua Chave de API RunAPI.
  4. Em Custom Model Name, adicione um identificador exato do Catálogo de Modelos e selecione-o para o chat atual.

Esta configuração é o endpoint raiz do NextChat, não a URL Base compatível com OpenAI usada por um SDK OpenAI. O NextChat acrescenta v1/chat/completions automaticamente, produzindo https://runapi.ai/v1/chat/completions. Seu cliente OpenAI não busca a lista de modelos do RunAPI, portanto adicione o identificador manualmente em vez de aguardar a descoberta.

Configurar uma implantação auto-hospedada

Para uma instalação auto-hospedada, defina estas variáveis de ambiente e reimplante ou reinicie a aplicação:

SHELL 
BASE_URL=https://runapi.ai
OPENAI_API_KEY=YOUR_RUNAPI_API_TOKEN
CUSTOM_MODELS=+YOUR_RUNAPI_MODEL_ID

O prefixo + adiciona o modelo sem substituir as entradas de modelo existentes da aplicação.

Verificar a conexão

Inicie um novo chat, selecione o modelo RunAPI personalizado e envie Reply with the word connected. Uma resposta normal completa ou em streaming confirma que o endpoint personalizado está ativo.

Solucionar problemas

  • A URL da requisição contém /v1/v1/chat/completions: remova /v1 do endereço do endpoint e use https://runapi.ai.
  • NextChat ainda usa um modelo integrado: adicione o identificador exato em Custom Model Name e selecione-o novamente no chat atual.
  • As configurações web não têm efeito: confirme que Custom Endpoint está habilitado; os aplicativos desktop e Web tratam esse switch de forma diferente.
  • Alterações em instâncias auto-hospedadas não têm efeito: reinicie ou reimplante após alterar BASE_URL, OPENAI_API_KEY ou CUSTOM_MODELS.

Para 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.