PandaNpc memorizza le connessioni ai provider e le voci di modello che configuri. Inizia con la chiave API, l'URL di base, il protocollo e l'ID del modello forniti dal tuo servizio. L'aggiunta di una voce non crea un account上游 o concede l'accesso al modello.
Per la distinzione tra un provider e un modello, leggi Gestisci il tuo elenco di modelli personalizzati.
Prima di iniziare
Conferma con il tuo provider o servizio self-hosted quanto segue:
- L'indirizzo di base dell'API, non l'indirizzo del sito web del provider.
- Il metodo di autenticazione e eventuali credenziali richieste.
- Il protocollo API supportato dalla funzionalità o dal motore che intendi utilizzare.
- L'ID del modello esatto che il tuo account può chiamare.
- I limiti di contesto e di output se intendi inserirli manualmente.
Mantieni le credenziali nel modulo del provider, non in prompt, screenshot o note condivise. Un servizio pubblicizzato come compatibile con OpenAI può comunque differire in streaming, chiamate di strumenti o supporto immagini.
1. Aggiungi o configura un provider
Apri Configurazione Modelli. Aggiungi un provider, configura un preset esistente o copia un preset quando hai bisogno di una connessione modificabile in modo indipendente.
| Campo | Cosa inserire |
|---|---|
| Nome visualizzato | Un nome riconoscibile per questa connessione |
| ID Provider | Un identificatore per la configurazione del provider |
| Chiave API | La credenziale richiesta dal tuo servizio |
| URL di base | L'indirizzo di base dell'API previsto dall'integrazione scelta |
| Protocollo | Il formato che l'API upstream implementa effettivamente |
| Segreto, Organizzazione, Progetto | Solo i valori esplicitamente richiesti dal tuo servizio |
| Supporto array di contenuti | Se il servizio accetta contenuti di messaggi strutturati |
La forma dell'URL di base dipende dal protocollo e dalla funzionalità che effettua le richieste. Non aggiungere un percorso completo dell'operazione se l'integrazione lo aggiunge già. Ad esempio, un'integrazione che aggiunge /chat/completions richiede l'indirizzo di base corrispondente, non un indirizzo che termina già con quel percorso. Non applicare quell'esempio a ogni protocollo.
Quando modifichi credenziali memorizzate, lasciare vuota la Chiave API o il Segreto preserva il valore configurato. Un valore mascherato mostrato in un elenco non è la chiave originale e non deve essere incollato come sostituto.
2. Aggiungi il modello
Salva il provider, selezionalo e scegli Aggiungi Modello.
| Campo | Significato |
|---|---|
| Nome visualizzato | La tua etichetta nell'elenco dei modelli |
| Valore Modello | L'ID esatto del modello upstream |
| Tipo di Modello | La categoria applicabile nel modulo di configurazione |
| Provider | La connessione utilizzata da questa voce |
| Finestra di Contesto | La capacità di contesto documentata, quando specificata |
| Max Token | Il limite di output, quando specificato |
Usa un ID dalla documentazione del servizio o dall'elenco dei modelli. Un nome commerciale non è necessariamente un identificatore API. Lascia eventuali limiti opzionali non impostati se non puoi verificarli; non impostato non significa che i limiti reali siano stati rilevati. La funzionalità che consuma può applicare i propri valori predefiniti.
3. Verifica la configurazione
Nella funzionalità o nel motore che utilizza queste impostazioni:
- Seleziona la nuova voce e avvia una conversazione di prova.
- Invia una breve richiesta come
Rispondi con: connesso. - Conferma una risposta normale e, dove disponibile, una richiesta corrispondente nei registri di utilizzo del provider.
- Invia un messaggio di follow-up per verificare la conversazione continua.
- Testa immagini o chiamate di strumenti separatamente se il tuo lavoro lo richiede.
Salvare il record non è un test di connessione. Una risposta testuale non stabilisce la compatibilità con ogni funzionalità. Modificare una voce di modello non riconfigura automaticamente un processo esistente di Claude Code o Codex; vedi PandaPaw.
Risoluzione dei problemi
L'autenticazione fallisce
Controlla se la chiave è attiva, se l'account può accedere al modello e se il servizio richiede campi di autenticazione aggiuntivi. Sostituisci le credenziali scadute tramite il modulo del provider.
L'endpoint o il modello non viene trovato
Controlla sia l'URL di base che il Valore Modello. Cerca percorsi di operazione duplicati, un prefisso API mancante o un ID modello non disponibile per il tuo account. Lo stesso errore può avere cause diverse tra i provider.
Appare un errore di rete o del browser
Controlla la connettività dal dispositivo che invia effettivamente la richiesta. Le richieste originate dal browser sono soggette a restrizioni CORS e HTTPS; una richiesta funzionante da un altro computer non prova che il percorso del browser funzioni.
Un server di modelli locale non è raggiungibile
localhost si riferisce alla macchina che effettua la richiesta. Non punta automaticamente al tuo computer remoto PandaPaw. Conferma dove viene eseguita la funzionalità che consuma prima di scegliere l'indirizzo del tuo server locale.
Il testo funziona ma immagini, strumenti o sessioni lunghe falliscono
Controlla la combinazione esatta di motore, protocollo API e capacità del modello. Usa i limiti supportati dal provider e verifica ogni tipo di input richiesto. Aumentare la Finestra di Contesto o cambiare il Tipo di Modello non aggiunge capacità upstream.
Per la distinzione tra appartenenza alla piattaforma e utilizzo del provider, vedi account e costi dei modelli.