Naar inhoud springen
Developer Resources
Developer Resources

Open WebUI

Installeer Open WebUI, voeg RunAPI toe als een OpenAI-compatibele verbinding, selecteer een model en verifieer een chat.

Markdown bekijken

Verbind Open WebUI met RunAPI via de OpenAI-compatibele verbinding. U heeft beheerderstoegang tot Open WebUI en een standaard RunAPI API-sleutel nodig uit de Authenticatiehandleiding.

Open WebUI installeren

Volg de officiële Open WebUI-snelstart voor uw platform. Voor een lokale Docker-installatie kan de officiële image worden gestart met:

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

Open de applicatie, maak het beheerdersaccount aan en meld u aan voordat u de verbinding toevoegt.

De RunAPI-verbinding toevoegen

  1. Open Admin Settings → Connections → OpenAI en selecteer Add Connection.
  2. Stel de URL in op https://runapi.ai/v1 en voer uw RunAPI API-sleutel in.
  3. Laat Model IDs (Filter) leeg bij de eerste verbindingspoging, zodat Open WebUI de beschikbare modellen kan ontdekken.
  4. Sla de verbinding op en wacht tot de verificatie is voltooid.

Open WebUI verstuurt de verbindingscontrole vanuit de backend en gebruikt GET /v1/models voor detectie. De RunAPI-URL is openbare HTTPS, dus een Docker-installatie heeft host.docker.internal niet nodig voor deze verbinding.

Een model selecteren

Open een nieuwe chat en selecteer een RunAPI-model in de chatmodelselector. Gebruik de Modelcatalogus om de actuele modelidentificator en mogelijkheden te bevestigen.

Als de selector niet wordt gevuld door detectie, bewerk dan de verbinding en voeg de exacte identifier toe onder Model-ID’s (Filter). Een modeldetectiefout en een Chat Completions-fout zijn afzonderlijke signalen; test het handmatig toegevoegde model voordat u de verbinding verwijdert.

De verbinding verifiëren

Stuur een korte prompt zoals Reply with the word connected. Een normale gestreamde of volledige respons bevestigt dat Open WebUI het geselecteerde RunAPI-model kan gebruiken.

Probleemoplossing

  • Verificatie geeft 401 of 403 terug: vervang de API-sleutel in de verbinding door een geldige standaardsleutel via de Authenticatiehandleiding.
  • Er verschijnt geen RunAPI-model: controleer of de URL eindigt op /v1, voeg daarna één actuele identificator toe aan Model IDs (Filter) en probeer de chat opnieuw.
  • Het model is zichtbaar maar de chat mislukt: controleer of de identificator OpenAI-compatibele Chat Completions ondersteunt in de Modelcatalogus en raadpleeg de Open WebUI-backendlogboeken voor de verzoekstatus.
  • Een lokale URL werkt in de browser maar niet in Open WebUI: Open WebUI-verbindingen komen voort vanuit de backend. Dit heeft geen invloed op de publieke URL https://runapi.ai/v1, maar is wel relevant voor andere lokale verbindingen.

Gebruik de LLM API-snelstart voor het gedeelde protocolgedrag. Gebruik de Chat Completions API-referentie voor aanvraag- en antwoordvelden.