---
title: Open WebUI | RunAPI
description: Open WebUI'yi yükleyin, RunAPI'yi OpenAI uyumlu bir bağlantı olarak ekleyin,
  bir model seçin ve sohbeti doğrulayın.
url: https://runapi.ai/tr/docs/resources/application-practices/open-webui.md
canonical: https://runapi.ai/tr/docs/resources/application-practices/open-webui
locale: tr
---

> HTML sürümü: https://runapi.ai/tr/docs/resources/application-practices/open-webui
> Ajanlar için site dizini: https://runapi.ai/llms.txt

# Open WebUI

Open WebUI'yi OpenAI uyumlu Bağlantısı aracılığıyla RunAPI'ye bağlayın. Open WebUI yönetici erişimine ve [Kimlik Doğrulama Kılavuzu](https://runapi.ai/tr/docs/guides/authentication.md)'ndan alınmış standart bir RunAPI API anahtarına ihtiyacınız vardır.

## Open WebUI'yi Yükle

Platformunuz için [resmi Open WebUI hızlı başlangıç kılavuzunu][1] takip edin. Yerel bir Docker kurulumu için resmi imaj şu komutla başlatılabilir:



[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
```

Uygulamayı açın, yönetici hesabı oluşturun ve bağlantıyı eklemeden önce oturum açın.

## RunAPI bağlantısını ekleyin

1.  **Admin Settings → Connections → OpenAI** bölümünü açın, ardından **Add Connection** seçeneğini belirleyin.
2.  URL'yi `https://runapi.ai/v1` olarak ayarlayın ve RunAPI API anahtarınızı girin.
3.  Open WebUI'nin mevcut modelleri keşfedebilmesi için ilk bağlantı denemesinde **Model IDs (Filter)** alanını boş bırakın.
4.  Bağlantıyı kaydedin ve doğrulamanın tamamlanmasını bekleyin.

Open WebUI, bağlantı kontrolünü arka ucundan gönderir ve keşif için `GET
/v1/models` kullanır. RunAPI URL'si genel HTTPS olduğundan, bir Docker kurulumunun bu bağlantı için `host.docker.internal` kullanmasına gerek yoktur.

## Bir model seçin

Yeni bir sohbet açın ve sohbet modeli seçicisinden bir RunAPI modeli seçin. Güncel model tanımlayıcısını ve yeteneklerini doğrulamak için [Model Kataloğu](https://runapi.ai/tr/models)'nu kullanın.

Keşif seçiciyi doldurmuyorsa bağlantıyı düzenleyin ve **Model IDs (Filter)** altına tam tanımlayıcıyı ekleyin. Model keşif hatası ile Chat Completions hatası birbirinden bağımsız sinyallerdir; bağlantıyı kaldırmadan önce elle eklenen modeli test edin.

## Bağlantıyı doğrulayın

`Reply with the word connected.` gibi kısa bir istem gönderin. Normal bir akışlı veya tam yanıt, Open WebUI'nin seçili RunAPI modelini kullanabildiğini doğrular.

## Sorun giderme

* **Doğrulama `401` veya `403` döndürüyor:** Bağlantıdaki API anahtarını [Kimlik Doğrulama Kılavuzu](https://runapi.ai/tr/docs/guides/authentication.md) üzerinden alınan geçerli bir standart anahtarla değiştirin.
* **Hiçbir RunAPI modeli görünmüyor:** URL'nin `/v1` ile bittiğini onaylayın, ardından **Model IDs (Filter)** alanına güncel bir tanımlayıcı ekleyip sohbeti yeniden deneyin.
* **Model görünüyor ancak sohbet başarısız oluyor:** Tanımlayıcının [Model Kataloğu](https://runapi.ai/tr/models) sayfasında OpenAI uyumlu Chat Completions desteklediğini onaylayın, ardından istek durumu için Open WebUI arka uç günlüklerini inceleyin.
* **Yerel URL tarayıcıda çalışıyor ancak Open WebUI'da çalışmıyor:** Open WebUI bağlantıları arka ucundan kaynaklanır. Bu, genel `https://runapi.ai/v1` URL'sini etkilemez; ancak diğer yerel bağlantılar için önemlidir.

Ortak protokol davranışı için [LLM API Hızlı başlangıç](https://runapi.ai/tr/docs/guides/llm-api/quickstart.md) bölümünü kullanın. İstek ve yanıt alanları için [Chat Completions API Başvurusu](https://runapi.ai/tr/docs/api/openai/chat-completions.md) bölümüne bakın.

---

## RunAPI hakkında daha fazlası

- [Ana sayfa](https://runapi.ai/tr/.md)
- [Model Kataloğu](https://runapi.ai/tr/models.md)
- [Fiyatlandırma](https://runapi.ai/tr/pricing.md)
- [Sağlayıcılar](https://runapi.ai/tr/models)
- [Dokümantasyon](https://runapi.ai/tr/docs/guides)
- [SDK'lar](https://runapi.ai/tr/sdk.md)
- [CLI](https://runapi.ai/tr/cli.md)
- [MCP Sunucusu](https://runapi.ai/tr/mcp.md)
- [Claude Code ve Cursor](https://runapi.ai/tr/claude-code-vs-cursor.md)
- [Cursor API kurulumu](https://runapi.ai/tr/cursor-api-setup.md)
- [RunAPI ve OpenRouter](https://runapi.ai/tr/openrouter-alternative.md)
- [Kurumsal](https://runapi.ai/tr/contact.md)
- [İletişim](https://runapi.ai/tr/contact.md)
- [Şartlar](https://runapi.ai/tr/terms.md)
- [Gizlilik](https://runapi.ai/tr/privacy.md)
- [Ajanlar için site dizini](https://runapi.ai/llms.txt)

İletişim: contact@runapi.ai

## Yapılandırılmış veriler

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/tr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/tricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "TechArticle",
    "headline": "Open WebUI",
    "description": "Open WebUI'yi yükleyin, RunAPI'yi OpenAI uyumlu bir bağlantı olarak ekleyin, bir model seçin ve sohbeti doğrulayın.",
    "url": "https://runapi.ai/tr/docs/resources/application-practices/open-webui",
    "mainEntityOfPage": "https://runapi.ai/tr/docs/resources/application-practices/open-webui"
  }
]
```