Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Chatbox AI

Installa Chatbox AI, aggiungi un provider personalizzato RunAPI, recupera un modello, esegui il controllo della connessione e verifica una chat.

Visualizza Markdown

Connetti Chatbox AI a RunAPI con un provider BYOK personalizzato. I nomi riportati di seguito seguono l’interfaccia del provider personalizzato corrente; le etichette possono variare leggermente tra le versioni desktop. Crea una Chiave API RunAPI standard nella Guida all’Autenticazione prima di continuare.

Installa Chatbox AI

Scarica Chatbox AI dalla sua pagina di download ufficiale o dalle versioni ufficiali, quindi apri Impostazioni.

Aggiungi il provider RunAPI

  1. Apri AI Provider / Model Settings e seleziona Add Provider.
  2. Assegnagli il nome RunAPI e scegli OpenAI API Compatible come modalità API.
  3. Inserisci la tua chiave API RunAPI.
  4. Imposta API Host su https://runapi.ai/v1 e API Path su /chat/completions.
  5. Verifica che l’anteprima dell’URL termini con https://runapi.ai/v1/chat/completions, quindi salva.

Mantieni Host e Path separati. Fetch costruisce il rilevamento dei modelli dall’Host con /models, mentre la chat utilizza l’Host più il Path API configurato.

Aggiungi e verifica un modello

Seleziona Recupera per caricare l’inventario dei modelli RunAPI. Se il rilevamento non è disponibile, seleziona Nuovo e inserisci un identificatore esatto dal Catalogo Modelli. Chatbox AI necessita di almeno un modello salvato prima che Controlla possa essere eseguito.

Seleziona Controlla, scegli il modello salvato ed esegui il test di connessione. Considера una Richiesta Testo riuscita come segnale di riferimento. Richiesta Vision e Richiesta Tool Use dipendono dalle capacità del modello selezionato e possono fallire indipendentemente senza invalidare la chat testuale di base.

Verifica la connessione

Avvia una nuova chat, scegli il modello RunAPI salvato nel selettore modelli e invia Reply with the word connected. Una risposta normale conferma che il provider personalizzato è attivo.

Risoluzione dei problemi

  • L’anteprima dell’URL è errata: usa Host https://runapi.ai/v1 e Path /chat/completions; non inserire l’URL completo dell’operazione in entrambi i campi.
  • Il Check è disabilitato o non ha nessun modello: usa Fetch o New per aggiungere almeno un modello prima.
  • Text Request non riesce con un errore di autenticazione: aggiorna il provider con una chiave standard valida dalla Authentication Guide.
  • Text funziona ma Vision o Tool Use non funzionano: scegli un modello che dichiari la funzionalità richiesta nel Model Catalog; questi check non sono requisiti universali del provider.

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.