Tavern Studio Scarica/prova
Tavern Studio Docs · 04

Configura la tua prima API

Per generare risposte, Tavern Studio necessita di un modello backend. Questa guida spiega come connettere un'API cloud o un endpoint compatibile con OpenAI.

Per chi è questo

  • Utenti che desiderano utilizzare modelli cloud come i servizi compatibili con OpenAI.
  • Gli utenti vedono errori di connessione o elenchi di modelli mancanti.
  • Utenti che desiderano assegnare percorsi modello diversi a chat diverse.

Cosa imparerai

  • Cosa significano URL di base, chiave API e nome del modello.
  • Come funzionano le API compatibili con OpenAI.
  • Come risolvere i problemi comuni di connessione.
  • In che modo le sostituzioni del modello a livello di chat si inseriscono nel flusso di lavoro.

Perché configurare un'API?

Tavern Studio gestisce i tuoi personaggi e il contesto, ma un modello backend genera il testo. La connessione API indica a Tavern Studio dove inviare il prompt e quale modello dovrebbe rispondere.

[!WARNING]> Le chiavi API sono credenziali private. Non condividerli in screenshot, log o post pubblici.

Tipi di provider comuni

  • Fornitori cloud ufficiali: servizi per i quali disponi di un account diretto e di una chiave API.
  • Gateway di terze parti: servizi che espongono un endpoint API compatibile.
  • API compatibili con OpenAI: un protocollo comune utilizzato da molti servizi cloud e di modelli locali.

Chiave, URL e modello

Apri Impostazioni, trova la sezione API e configura:

  1. Provider: scegli il tipo di fornitore.
  2. URL di base: inserisci l'URL dell'endpoint.
  3. Chiave API: incolla la tua chiave privata.
  4. Aggiorna modelli: carica i modelli disponibili.
  5. Modella: scegli la modella per la chat.

Se il provider è compatibile ma l'elenco dei modelli non viene caricato, potresti comunque riuscire a inserire manualmente il nome del modello se la versione dell'app lo supporta.

Sostituzioni a livello di chat

Le impostazioni API globali definiscono il backend predefinito. Le chat individuali possono sovrascrivere il modello o passare attraverso le Impostazioni chat, il che è utile quando personaggi diversi necessitano di modelli o costi diversi.

Risoluzione dei problemi di connessione

Controlla l'URL di base

Alcuni provider richiedono/v1, mentre altri lo includono già. Evitare di duplicare o omettere il percorso richiesto.

Controlla le impostazioni di rete e proxy

Se la tua rete non riesce a raggiungere il provider, configura un proxy se il tuo ambiente ne richiede uno.

Controlla la quota dell'account

I crediti di prova scaduti o il saldo insufficiente possono causare errori di autenticazione o di quota anche quando la chiave è corretta.

Domande frequenti

Perché posso aggiornare i modelli ma la chat continua a non funzionare?

Il modello selezionato potrebbe non essere disponibile per la generazione della chat oppure il nome del modello potrebbe differire da quello previsto dal provider.

Posso digitare manualmente il nome di un modello?

Utilizza l'elenco dei modelli quando possibile. I nomi dei modelli manuali devono corrispondere all'identificatore esatto del fornitore.

Perché il comportamento è cambiato dopo aver cambiato modello?

Diversi modelli rispondono in modo diverso alla stessa richiesta e preimpostazione. Rivedi la tua preimpostazione dopo aver cambiato modello.

Passaggi successivi