Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Open WebUI

Installa Open WebUI, aggiungi RunAPI come connessione compatibile con OpenAI, seleziona un modello e verifica una chat.

Visualizza Markdown

Connetti Open WebUI a RunAPI tramite la sua Connessione compatibile con OpenAI. È necessario avere accesso come amministratore di Open WebUI e una Chiave API RunAPI standard dalla Guida all’Autenticazione.

Installa Open WebUI

Segui la guida introduttiva ufficiale di Open WebUI per la tua piattaforma. Per un’installazione Docker locale, l’immagine ufficiale può essere avviata con:

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

Apri l’applicazione, crea l’account amministratore e accedi prima di aggiungere la connessione.

Aggiungi la connessione RunAPI

  1. Apri Admin Settings → Connections → OpenAI, poi seleziona Add Connection.
  2. Imposta l’URL su https://runapi.ai/v1 e inserisci la tua chiave API RunAPI.
  3. Lascia Model IDs (Filter) vuoto per il primo tentativo di connessione in modo che Open WebUI possa rilevare i modelli disponibili.
  4. Salva la connessione e attendi il completamento della verifica.

Open WebUI invia il controllo della connessione dal suo backend e utilizza GET /v1/models per la discovery. L’URL di RunAPI è HTTPS pubblico, quindi un’installazione Docker non necessita di host.docker.internal per questa connessione.

Seleziona un modello

Apri una nuova chat e seleziona un modello RunAPI dal selettore del modello di chat. Usa il Catalogo Modelli per confermare l’identificatore del modello corrente e le sue funzionalità.

Se la rilevazione non popola il selettore, modifica la connessione e aggiungi l’identificatore esatto sotto ID Modello (Filtro). Un errore di rilevazione del modello e un errore di Chat Completions sono segnali separati; testa il modello aggiunto manualmente prima di rimuovere la connessione.

Verifica la connessione

Invia un breve prompt come Reply with the word connected. Una risposta normale, in streaming o completa, conferma che Open WebUI può utilizzare il modello RunAPI selezionato.

Risoluzione dei problemi

  • La verifica restituisce 401 o 403: sostituisci la Chiave API nella connessione con una chiave standard valida dalla Authentication Guide.
  • Non compare nessun modello RunAPI: conferma che l’URL termini con /v1, quindi aggiungi un identificatore aggiornato in Model IDs (Filter) e riprova la chat.
  • Il modello è visibile ma la chat non funziona: conferma che l’identificatore supporti Chat Completions compatibili con OpenAI nel Model Catalog, quindi ispeziona i log del backend di Open WebUI per lo stato della richiesta.
  • Un URL locale funziona nel browser ma non in Open WebUI: le connessioni di Open WebUI hanno origine dal suo backend. Questo non riguarda l’URL pubblico https://runapi.ai/v1, ma è rilevante per altre connessioni locali.

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.