--- title: Open WebUI | RunAPI description: Instale o Open WebUI, adicione o RunAPI como uma conexão compatível com OpenAI, selecione um modelo e verifique um chat. url: https://runapi.ai/pt-BR/docs/resources/application-practices/open-webui.md canonical: https://runapi.ai/pt-BR/docs/resources/application-practices/open-webui locale: pt-BR --- > Versão HTML: https://runapi.ai/pt-BR/docs/resources/application-practices/open-webui > Índice do site para agentes: https://runapi.ai/llms.txt # Open WebUI Conecte o Open WebUI ao RunAPI por meio de sua Conexão compatível com OpenAI. Você precisa de acesso de administrador ao Open WebUI e de uma Chave de API padrão do RunAPI do [Guia de Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md). ## Instalar Open WebUI Siga o [início rápido oficial do Open WebUI][1] para sua plataforma. Para uma instalação local com Docker, a imagem oficial pode ser iniciada com: [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 ``` Abra o aplicativo, crie a conta de administrador e faça login antes de adicionar a conexão. ## Adicionar a conexão RunAPI 1. Abra **Admin Settings → Connections → OpenAI** e selecione **Add Connection**. 2. Defina a URL como `https://runapi.ai/v1` e insira sua Chave de API do RunAPI. 3. Deixe **Model IDs (Filter)** vazio na primeira tentativa de conexão para que o Open WebUI possa descobrir os modelos disponíveis. 4. Salve a conexão e aguarde a conclusão da verificação. O Open WebUI envia a verificação de conexão a partir do seu backend e usa `GET /v1/models` para descoberta. A URL do RunAPI é HTTPS pública, portanto uma instalação Docker não precisa de `host.docker.internal` para esta conexão. ## Selecionar um modelo Abra um novo chat e selecione um modelo RunAPI no seletor de modelos do chat. Use o [Catálogo de Modelos](https://runapi.ai/pt-BR/models) para confirmar o identificador e as capacidades atuais do modelo. Se a descoberta não preencher o seletor, edite a conexão e adicione o identificador exato em **Model IDs (Filter)**. Um erro de descoberta de modelo e um erro de Chat Completions são sinais separados; teste o modelo adicionado manualmente antes de remover a conexão. ## Verificar a conexão Envie um prompt curto como `Reply with the word connected.` Uma resposta normal em streaming ou completa confirma que o Open WebUI pode usar o modelo RunAPI selecionado. ## Solucionar problemas * **A verificação retorna `401` ou `403`:** substitua a Chave de API na conexão por uma chave padrão válida do [Guia de Autenticação](https://runapi.ai/pt-BR/docs/guides/authentication.md). * **Nenhum modelo RunAPI aparece:** confirme que a URL termina em `/v1`, adicione um identificador atual em **Model IDs (Filter)** e tente o chat novamente. * **O modelo está visível, mas o chat falha:** confirme que o identificador suporta Chat Completions compatível com OpenAI no [Catálogo de Modelos](https://runapi.ai/pt-BR/models) e inspecione os logs do backend do Open WebUI para o status da requisição. * **Uma URL local funciona no navegador, mas não no Open WebUI:** as conexões do Open WebUI se originam do seu backend. Isso não afeta a URL pública `https://runapi.ai/v1`, mas é relevante para outras conexões locais. Para o comportamento de protocolo compartilhado, use o [Início rápido da API LLM](https://runapi.ai/pt-BR/docs/guides/llm-api/quickstart.md). Para campos de requisição e resposta, use a [Referência da API Chat Completions](https://runapi.ai/pt-BR/docs/api/openai/chat-completions.md). --- ## Mais de RunAPI - [Início](https://runapi.ai/pt-BR/.md) - [Catálogo de modelos](https://runapi.ai/pt-BR/models.md) - [Preços](https://runapi.ai/pt-BR/pricing.md) - [Provedores](https://runapi.ai/pt-BR/models) - [Documentação](https://runapi.ai/pt-BR/docs/guides) - [SDKs](https://runapi.ai/pt-BR/sdk.md) - [CLI](https://runapi.ai/pt-BR/cli.md) - [Servidor MCP](https://runapi.ai/pt-BR/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/pt-BR/claude-code-vs-cursor.md) - [Configuração da API do Cursor](https://runapi.ai/pt-BR/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/pt-BR/openrouter-alternative.md) - [Enterprise](https://runapi.ai/pt-BR/contact.md) - [Contato](https://runapi.ai/pt-BR/contact.md) - [Termos](https://runapi.ai/pt-BR/terms.md) - [Privacidade](https://runapi.ai/pt-BR/privacy.md) - [Índice do site para agentes](https://runapi.ai/llms.txt) Contato: contact@runapi.ai ## Dados estruturados ```json [ { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/pt-BR/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/pt-BR", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/pt-BRicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "pt-BR", "@type": "TechArticle", "headline": "Open WebUI", "description": "Instale o Open WebUI, adicione o RunAPI como uma conexão compatível com OpenAI, selecione um modelo e verifique um chat.", "url": "https://runapi.ai/pt-BR/docs/resources/application-practices/open-webui", "mainEntityOfPage": "https://runapi.ai/pt-BR/docs/resources/application-practices/open-webui" } ] ```