--- title: Open WebUI | RunAPI description: Installa Open WebUI, aggiungi RunAPI come connessione compatibile con OpenAI, seleziona un modello e verifica una chat. url: https://runapi.ai/it/docs/resources/application-practices/open-webui.md canonical: https://runapi.ai/it/docs/resources/application-practices/open-webui locale: it --- > Versione HTML: https://runapi.ai/it/docs/resources/application-practices/open-webui > Indice del sito per gli agenti: https://runapi.ai/llms.txt # Open WebUI 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](https://runapi.ai/it/docs/guides/authentication.md). ## Installa Open WebUI Segui la [guida introduttiva ufficiale di Open WebUI][1] per la tua piattaforma. Per un'installazione Docker locale, l'immagine ufficiale può essere avviata con: [1]: https://docs.openwebui.com/getting-started/quick-start/ ```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](https://runapi.ai/it/models) 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](https://runapi.ai/it/docs/guides/authentication.md). * **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](https://runapi.ai/it/models), 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](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": "Open WebUI", "description": "Installa Open WebUI, aggiungi RunAPI come connessione compatibile con OpenAI, seleziona un modello e verifica una chat.", "url": "https://runapi.ai/it/docs/resources/application-practices/open-webui", "mainEntityOfPage": "https://runapi.ai/it/docs/resources/application-practices/open-webui" } ] ```