---
title: NextChat | RunAPI
description: Connetti NextChat a RunAPI con un endpoint e un modello personalizzati.
url: https://runapi.ai/it/docs/resources/application-practices/nextchat.md
canonical: https://runapi.ai/it/docs/resources/application-practices/nextchat
locale: it
---

> Versione HTML: https://runapi.ai/it/docs/resources/application-practices/nextchat
> Indice del sito per gli agenti: https://runapi.ai/llms.txt

# NextChat

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](https://runapi.ai/it/docs/guides/authentication.md)
prima di continuare.

## Installa o distribuisci NextChat

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


[1]: https://github.com/ChatGPTNextWeb/NextChat

## 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](https://runapi.ai/it/models), 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](https://runapi.ai/it/docs/guides/llm-api/quickstart.md). Per i campi di richiesta e risposta, utilizza il [Riferimento API
Chat Completions](https://runapi.ai/it/docs/api/openai/chat-completions.md).

---

## Altre risorse di RunAPI

- [Home](https://runapi.ai/it/.md)
- [Catalogo dei modelli](https://runapi.ai/it/models.md)
- [Prezzi](https://runapi.ai/it/pricing.md)
- [Fornitori](https://runapi.ai/it/models)
- [Documentazione](https://runapi.ai/it/docs/guides)
- [SDK](https://runapi.ai/it/sdk.md)
- [CLI](https://runapi.ai/it/cli.md)
- [MCP Server](https://runapi.ai/it/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md)
- [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md)
- [Enterprise](https://runapi.ai/it/contact.md)
- [Contatti](https://runapi.ai/it/contact.md)
- [Termini](https://runapi.ai/it/terms.md)
- [Privacy](https://runapi.ai/it/privacy.md)
- [Indice del sito per gli agenti](https://runapi.ai/llms.txt)

Contatti: contact@runapi.ai

## Dati strutturati

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/it",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/iticon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "it",
    "@type": "TechArticle",
    "headline": "NextChat",
    "description": "Connetti NextChat a RunAPI con un endpoint e un modello personalizzati.",
    "url": "https://runapi.ai/it/docs/resources/application-practices/nextchat",
    "mainEntityOfPage": "https://runapi.ai/it/docs/resources/application-practices/nextchat"
  }
]
```
