Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

NextChat

Connetti NextChat a RunAPI con un endpoint e un modello personalizzati.

Visualizza Markdown

Connetti NextChat a RunAPI tramite il suo endpoint OpenAI personalizzato. NextChat compone il percorso dell’operazione in modo diverso rispetto agli altri client di questo gruppo, quindi utilizza il valore esatto dell’endpoint indicato di seguito. Crea una Chiave API RunAPI standard nella Guida all’Autenticazione prima di continuare.

Installa o distribuisci NextChat

Scegli una versione desktop o un metodo di distribuzione dal repository ufficiale NextChat, quindi apri Impostazioni.

Configura l'endpoint personalizzato

  1. Nell’applicazione Web, abilita Custom Endpoint e seleziona OpenAI. L’applicazione desktop utilizza sempre la configurazione personalizzata.
  2. Imposta l’indirizzo dell’endpoint su https://runapi.ai senza /v1.
  3. Inserisci la tua Chiave API RunAPI.
  4. In Custom Model Name, aggiungi un identificatore esatto dal Catalogo modelli, quindi selezionalo per la chat corrente.

Questa impostazione è la radice dell’endpoint di NextChat, non il Base URL compatibile con OpenAI utilizzato da un SDK OpenAI. NextChat aggiunge v1/chat/completions automaticamente, producendo https://runapi.ai/v1/chat/completions. Il suo client OpenAI non recupera l’elenco di modelli RunAPI, quindi aggiungi l’identificatore manualmente invece di attendere il rilevamento.

Configura una distribuzione self-hosted

Per un’installazione self-hosted, imposta queste variabili d’ambiente e ridistribuisci o riavvia l’applicazione:

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

Il prefisso + aggiunge il modello senza sostituire le voci di modello esistenti dell’applicazione.

Verifica la connessione

Avvia una nuova chat, seleziona il modello RunAPI personalizzato e invia Reply with the word connected. Una risposta normale, completa o in streaming, conferma che l’endpoint personalizzato è attivo.

Risoluzione dei problemi

  • L’URL della richiesta contiene /v1/v1/chat/completions: rimuovi /v1 dall’indirizzo dell’endpoint e usa https://runapi.ai.
  • NextChat continua a usare un modello integrato: aggiungi l’identificatore esatto sotto Custom Model Name, quindi riselezionalo nella chat corrente.
  • Le impostazioni Web non hanno effetto: conferma che Custom Endpoint sia abilitato; le applicazioni desktop e Web gestiscono questa opzione in modo diverso.
  • Le modifiche self-hosted non hanno effetto: riavvia o ridistribuisci dopo aver modificato BASE_URL, OPENAI_API_KEY o CUSTOM_MODELS.

Per il comportamento del protocollo condiviso, utilizza la Guida introduttiva all’API LLM. Per i campi di richiesta e risposta, utilizza il Riferimento API Chat Completions.