Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

NextChat

Conecte NextChat a RunAPI con un endpoint y modelo personalizados.

Ver Markdown

Conecte NextChat a RunAPI a través de su endpoint OpenAI personalizado. NextChat compone la ruta de operación de forma diferente a los otros clientes de este grupo, por lo que use el valor de endpoint exacto que se indica a continuación. Cree una Clave de API estándar de RunAPI en la Guía de Autenticación antes de continuar.

Instalar o implementar NextChat

Elija una versión de escritorio o método de despliegue del repositorio oficial de NextChat y abra Ajustes.

Configurar el endpoint personalizado

  1. En la aplicación web, habilite Custom Endpoint y seleccione OpenAI. La aplicación de escritorio siempre utiliza configuración personalizada.
  2. Establezca la dirección del endpoint en https://runapi.ai sin /v1.
  3. Introduzca su Clave de API de RunAPI.
  4. En Custom Model Name, agregue un identificador exacto del Catálogo de modelos y selecciónelo para el chat actual.

Esta configuración es el endpoint raíz de NextChat, no la URL base compatible con OpenAI que usa un SDK de OpenAI. NextChat añade v1/chat/completions por sí mismo, produciendo https://runapi.ai/v1/chat/completions. Su cliente de OpenAI no obtiene la lista de modelos de RunAPI, por lo que añade el identificador manualmente en lugar de esperar al descubrimiento.

Configurar un despliegue autohospedado

Para una instalación autohospedada, establezca estas variables de entorno y vuelva a implementar o reinicie la aplicación:

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

El prefijo + añade el modelo sin reemplazar las entradas de modelo existentes de la aplicación.

Verificar la conexión

Inicie un nuevo chat, seleccione el modelo de RunAPI personalizado y envíe Reply with the word connected. Una respuesta completa o en streaming normal confirma que el endpoint personalizado está activo.

Solución de problemas

  • La URL de solicitud contiene /v1/v1/chat/completions: elimina /v1 de la dirección del endpoint y usa https://runapi.ai.
  • NextChat sigue usando un modelo integrado: agrega el identificador exacto en Custom Model Name y luego vuelve a seleccionarlo en el chat actual.
  • La configuración web no tiene efecto: confirma que Custom Endpoint está habilitado; las aplicaciones de escritorio y web gestionan este interruptor de manera diferente.
  • Los cambios en la versión autoalojada no tienen efecto: reinicia o vuelve a desplegar después de cambiar BASE_URL, OPENAI_API_KEY o CUSTOM_MODELS.

Para el comportamiento de protocolo compartido, use el Inicio rápido de la API LLM. Para los campos de solicitud y respuesta, use la Referencia de la API de Chat Completions.