mirror of https://github.com/diegosouzapw/OmniRoute.git synced 2026-07-26 09:52:11 +03:00

Files

diegosouzapw fa886231d3 docs(i18n): apply deep machine translation to 33 languages

2026-04-06 18:14:01 -03:00

121 KiB

Raw Blame History

🚀 OmniRoute — The Free AI Gateway (Türkçe)

🌐 Languages: 🇺🇸 English · 🇪🇸 es · 🇫🇷 fr · 🇩🇪 de · 🇮🇹 it · 🇷🇺 ru · 🇨🇳 zh-CN · 🇯🇵 ja · 🇰🇷 ko · 🇸🇦 ar · 🇮🇳 hi · 🇮🇳 in · 🇹🇭 th · 🇻🇳 vi · 🇮🇩 id · 🇲🇾 ms · 🇳🇱 nl · 🇵🇱 pl · 🇸🇪 sv · 🇳🇴 no · 🇩🇰 da · 🇫🇮 fi · 🇵🇹 pt · 🇷🇴 ro · 🇭🇺 hu · 🇧🇬 bg · 🇸🇰 sk · 🇺🇦 uk-UA · 🇮🇱 he · 🇵🇭 phi · 🇧🇷 pt-BR · 🇨🇿 cs · 🇹🇷 tr

Never stop coding. Smart routing to FREE & low-cost AI models with automatic fallback.

Evrensel API proxy'niz — tek uç nokta, 60'tan fazla sağlayıcı, sıfır kesinti süresi. ArtıkMCP Sunucusu (25 araç),A2A Protokolü,Bellek/Beceri SistemleriveElectron Masaüstü Uygulaması. ile birlikte

Sohbet Tamamlamaları • Yerleştirmeler • Görüntü Oluşturma • Video • Müzik • Ses • Yeniden Sıralama •Web Araması• MCP Sunucusu • A2A Protokolü • %100 TypeScript---

🌐 Web sitesi • 🚀 Hızlı Başlangıç • 💡 Özellikler • 📖 Dokümanlar • [💰 Fiyatlandırma](#-bir bakışta fiyatlandırma) • 💬 WhatsApp

🖼️ Main Dashboard

📸 Dashboard Preview

Kontrol paneli ekran görüntülerini görmek için tıklayın

Sayfa	Ekran görüntüsü
Sağlayıcılar
Kombolar
Analiz
Sağlık
Çevirmen
Ayarlar
CLI Araçları
Kullanım Günlükleri
Uç noktalar

🤖 Free AI Provider for your favorite coding agents

Sınırsız kodlama için ücretsiz API ağ geçidi olan OmniRoute aracılığıyla yapay zeka destekli herhangi bir IDE veya CLI aracına bağlanın.

AçıkPençe
_{⭐ 205K}

NanoBot
_{⭐ 20,9K}

PicoClaw
_{⭐ 14,6K}

ZeroClaw
_{⭐ 9,9K}

DemirPençe
_{⭐ 2,1K}

Açık Kod
_{⭐ 106K}

Kodeks CLI
_{⭐ 60,8K}

Claude Kodu
_{⭐ 67,3K}

Gemini CLI
_{⭐ 94,7K}

Kilo Kodu
_{⭐ 15,5K}

_{📡 Tüm aracılar http://localhost:20128/v1 veya http://cloud.omniroute.online/v1 aracılığıyla bağlanır — tek yapılandırma, sınırsız model ve kota}---

🤔 Why OmniRoute?

Paranızı boşa harcamayı ve limitlere ulaşmayı bırakın:

Abonelik kotası kullanılmadan her ay sona erer
Hız sınırları kodlamanın ortasında sizi durdurur
Pahalı API'ler (sağlayıcı başına ayda 20-50 ABD doları)
Sağlayıcılar arasında manuel geçiş

OmniRoute bunu çözer:

✅Abonelikleri en üst düzeye çıkarın- Kotayı takip edin, sıfırlamadan önce her biti kullanın
✅Otomatik geri dönüş- Abonelik → API Anahtarı → Ucuz → Ücretsiz, sıfır kesinti
✅Çoklu hesap- Sağlayıcı başına hesaplar arasında dönüşümlü işlem
✅Evrensel- Claude Code, Codex, Gemini CLI, Cursor, Cline, OpenClaw ve herhangi bir CLI aracıyla çalışır---

📧 Support

💬Topluluğumuza katılın!WhatsApp Grubu — Yardım alın, ipuçlarını paylaşın ve güncel kalın.

-Web sitesi: omniroute.online -GitHub: github.com/diegosouzapw/OmniRoute -Sorunlar: github.com/diegosouzapw/OmniRoute/issues -WhatsApp: Topluluk Grubu -Katkıda bulunma: CONTRIBUTING.md'ye bakın, bir PR açın veya 'iyi bir ilk sayı' seçin -Orijinal Proje: 9router by decolua### 🐛 Reporting a Bug?

Bir sayıyı açarken lütfen sistem bilgisi komutunu çalıştırın ve oluşturulan dosyayı ekleyin:```bash npm run system-info


Bu, Node.js sürümünüz, OmniRoute sürümünüz, işletim sistemi ayrıntılarınız, yüklü CLI araçlarınız (qoder, gemini, Claude, codex, antigravity, droid vb.), Docker/PM2 durumunuz ve sistem paketlerinizle birlikte bir "system-info.txt" oluşturur; sorununuzu hızlı bir şekilde yeniden oluşturmak için ihtiyacımız olan her şey. Dosyayı doğrudan GitHub sorununuza ekleyin.---

## 🔄 How It Works

┌─────────────┐ │ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Tool │ └──────┬──────┘ │ http://localhost:20128/v1 ↓ ┌─────────────────────────────────────────┐ │ OmniRoute (Smart Router) │ │ • Format translation (OpenAI ↔ Claude) │ │ • Quota tracking + Embeddings + Images │ │ • Auto token refresh │ └──────┬──────────────────────────────────┘ │ ├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI │ ↓ quota exhausted ├─→ [Tier 2: API KEY] DeepSeek, Groq, xAI, Mistral, NVIDIA NIM, etc. │ ↓ budget limit ├─→ [Tier 3: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) │ ↓ budget limit └─→ [Tier 4: FREE] Qoder, Qwen, Kiro (unlimited)

Result: Never stop coding, minimal cost


---

## 🎯 What OmniRoute Solves — 30 Real Pain Points & Use Cases

>**Yapay zeka araçlarını kullanan her geliştirici bu sorunlarla her gün karşılaşır.**OmniRoute, maliyet aşımlarından bölgesel engellemelere, bozuk OAuth akışlarından protokol işlemlerine ve kurumsal gözlemlenebilirliğe kadar bunların hepsini çözmek için tasarlandı.

<detaylar>
<summary><b>💸 1. "Pahalı bir abonelik için para ödüyorum ama yine de limitler nedeniyle kesintiye uğruyorum"</b></summary>

Geliştiriciler Claude Pro, Codex Pro veya GitHub Copilot için ayda 20-200 ABD doları ödüyor. Ödeme yaparken bile kotanın bir tavanı vardır: 5 saatlik kullanım, haftalık limitler veya dakika başına ücret limitleri. Kodlama oturumunun ortasında sağlayıcı yanıt vermeyi durdurur ve geliştirici akış ve üretkenliği kaybeder.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Akıllı 4 Katmanlı Geri Dönüş**— Abonelik kotası biterse, sıfır manuel müdahaleyle otomatik olarak API Anahtarı → Ucuz → Ücretsiz seçeneğine yönlendirilir
-**Sağlayıcı Sınırları Takibi**— Önbelleğe alınmış kota anlık görüntüleri, kullanıcı arayüzünde manuel yenileme özelliğiyle sunucu tarafı bir programa göre (varsayılan `PROVIDER_LIMITS_SYNC_INTERVAL_MINUTES=70`) yenilenir
-**Çoklu Hesap Desteği**— Otomatik hepsini bir kez deneme özelliğiyle sağlayıcı başına birden fazla hesap — biri bittiğinde diğerine geçiş yapılır
-**Özel Kombinasyonlar**— 9 dengeleme stratejisiyle özelleştirilebilir geri dönüş zincirleri (öncelik, ağırlıklı, önce doldur, hepsini bir kez deneme, P2C, rastgele, en az kullanılan, maliyeti optimize edilmiş, katı rastgele)
-**Codex Business Kotaları**— İşletme/Ekip çalışma alanı kotasını doğrudan kontrol panelinden izleme</details>

<detaylar>
<summary><b>🔌 2. "Birden fazla sağlayıcı kullanmam gerekiyor ancak her birinin farklı bir API'si var"</b></summary>

OpenAI bir format kullanıyor, Claude (Anthropic) başka bir format kullanıyor, Gemini ise bir başka format kullanıyor. Bir geliştirici, farklı sağlayıcıların modellerini test etmek veya bunlar arasında geri dönüş yapmak isterse, SDK'ları yeniden yapılandırması, uç noktaları değiştirmesi ve uyumsuz formatlarla uğraşması gerekir. Özel sağlayıcıların (FriendLI, NIM) standart dışı model uç noktaları vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Birleşik Uç Nokta**— Tek bir "http://localhost:20128/v1", 60'tan fazla sağlayıcının tümü için proxy görevi görür
-**Biçim Çevirisi**— Otomatik ve şeffaf: OpenAI ↔ Claude ↔ Gemini ↔ Responses API
-**Response Temizleme**— OpenAI SDK v1.83+'ı bozan standart olmayan alanları (`x_groq`, `usage_breakdown`, `service_tier`) çıkarır
-**Rol Normalleştirme**— OpenAI olmayan sağlayıcılar için "geliştirici" → "sistem"i dönüştürür; GLM/ERNIE için "sistem" → "kullanıcı"
-**Think Tag Extraction**— DeepSeek R1 gibi modellerden "<think>" bloklarını standartlaştırılmış "reasoning_content"e çıkarır
-**Gemini için Yapılandırılmış Çıktı**— `json_schema` → `responseMimeType`/`responseSchema` otomatik dönüştürme
-**`stream` varsayılan olarak `false` olur**— Python/Rust/Go SDK'larında beklenmeyen SSE'yi önleyerek OpenAI spesifikasyonuyla uyumlu hale gelir</details>

<detaylar>
<summary><b>🌐 3. "Yapay zeka sağlayıcım bölgemi/ülkemi engelliyor"</b></summary>

OpenAI/Codex gibi sağlayıcılar belirli coğrafi bölgelerden erişimi engelliyor. Kullanıcılar, OAuth ve API bağlantıları sırasında "desteklenmeyen_ülke_bölge_territory" gibi hatalar alıyor. Bu özellikle gelişmekte olan ülkelerdeki geliştiriciler için sinir bozucudur.

**OmniRoute bu sorunu nasıl çözüyor:**

-**3 Düzeyli Proxy Yapılandırması**— 3 düzeyde yapılandırılabilir proxy: genel (tüm trafik), sağlayıcı başına (yalnızca bir sağlayıcı) ve bağlantı/anahtar başına
-**Renk Kodlu Proxy Rozetleri**— Görsel göstergeler: 🟢 genel proxy, 🟡 sağlayıcı proxy, 🔵 bağlantı proxy'si, her zaman IP'yi gösterir
-**Proxy Aracılığıyla OAuth Token Değişimi**— OAuth akışı da proxy üzerinden geçerek "unsupported_country_region_territory" sorununu çözer
-**Proxy Aracılığıyla Bağlantı Testleri**— Bağlantı testleri yapılandırılmış proxy'yi kullanır (artık doğrudan geçiş yok)
-**SOCKS5 Desteği**— Giden yönlendirme için tam SOCKS5 proxy desteği
-**TLS Parmak İzi Sahtekarlığı**— Bot tespitini atlamak için "wreq-js" aracılığıyla tarayıcı benzeri TLS parmak izi
-**🔏 CLI Parmak İzi Eşleştirme**— Başlıkları ve gövde alanlarını yerel CLI ikili imzalarıyla eşleşecek şekilde yeniden sıralayarak hesap işaretleme riskini büyük ölçüde azaltır. Proxy IP'si korunur; aynı anda hem gizli**hem de**IP maskeleme elde edersiniz</details>

<detaylar>
<summary><b>🆓 4. "Kodlama için yapay zeka kullanmak istiyorum ama param yok"</b></summary>

AI abonelikleri için herkes ayda 20-200 ABD Doları ödeyemez. Öğrencilerin, gelişmekte olan ülkelerdeki geliştiricilerin, amatörlerin ve serbest çalışanların kaliteli modellere sıfır maliyetle erişmesi gerekiyor.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Yerleşik Ücretsiz Katman Sağlayıcıları**— %100 ücretsiz sağlayıcılar için yerel destek: Qoder (OAuth aracılığıyla 5 sınırsız model: kimi-k2-thinking, qwen3-coder-plus, deepseek-r1, minimax-m2, kimi-k2), Qwen (4 sınırsız model: qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next, vizyon-model), Kiro (ücretsiz Claude + AWS Builder ID), Gemini CLI (ayda 180.000 jeton ücretsiz)
-**Ollama Cloud**— "api.ollama.com" adresinde ücretsiz "Hafif kullanım" katmanıyla bulutta barındırılan Ollama modelleri; 'ollamacloud/<model>' önekini kullan
-**Yalnızca Ücretsiz Kombinasyonlar**— Zincir `gc/gemini-3-flash → if/kimi-k2-thinking → qw/qwen3-coder-plus` = sıfır kesinti süresiyle ayda 0 ABD doları
-**NVIDIA NIM Ücretsiz Erişim**— ~40 RPM geliştirici-build.nvidia.com adresinde 70'ten fazla modele sonsuza kadar ücretsiz erişim (kredilerden saf hız sınırlarına geçiş)
-**Maliyet Optimize Edilmiş Strateji**— Mevcut en ucuz sağlayıcıyı otomatik olarak seçen yönlendirme stratejisi</details>

<detaylar>
<summary><b>🔒 5. "Yapay zeka ağ geçidimi yetkisiz erişime karşı korumam gerekiyor"</b></summary>

Bir AI ağ geçidini ağa (LAN, VPS, Docker) sunarken, adrese sahip olan herkes geliştiricinin belirteçlerini/kotasını kullanabilir. Koruma olmadan API'ler kötüye kullanıma, anında enjeksiyona ve kötüye kullanıma karşı savunmasızdır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**API Anahtar Yönetimi**— Özel bir "/dashboard/api-manager" sayfasıyla sağlayıcı başına oluşturma, döndürme ve kapsam belirleme
-**Model Düzeyinde İzinler**— Tümüne İzin Ver/Kısıtla geçişiyle API anahtarlarını belirli modellerle ('openai/*', joker karakter desenleri) kısıtlayın
-**API Uç Nokta Koruması**— `/v1/models' için bir anahtar zorunlu kılın ve belirli sağlayıcıların listede yer almasını engelleyin
-**Auth Guard + CSRF Koruması**— Tüm kontrol paneli rotaları "withAuth" ara yazılımı + CSRF belirteçleriyle korunur
-**Hız Sınırlayıcı**— Yapılandırılabilir pencerelerle IP başına hız sınırlaması
-**IP Filtreleme**— Erişim kontrolü için izin verilenler listesi/engellenenler listesi
-**Prompt Injection Guard**— Kötü niyetli istem kalıplarına karşı temizleme
-**AES-256-GCM Şifreleme**— Kullanımda değilken şifrelenen kimlik bilgileri</details>

<detaylar>
<summary><b>🛑 6. "Sağlayıcım arızalandı ve kodlama akışımı kaybettim"</b></summary>

Yapay zeka sağlayıcıları kararsız hale gelebilir, 5xx hataları döndürebilir veya geçici hız sınırlarına ulaşabilir. Bir geliştirici tek bir sağlayıcıya bağlıysa kesintiye uğrar. Devre kesiciler olmadan tekrarlanan yeniden denemeler uygulamanın çökmesine neden olabilir.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Model başına Devre Kesici**— Yapılandırılabilir eşikler ve bekleme süresi (Kapalı/Açık/Yarı Açık) ile otomatik açma/kapama, basamaklı blokları önlemek için model başına kapsamlıdır
-**Üstel Gerileme**— Aşamalı yeniden deneme gecikmeleri
-**Gök Gürültüsü Önleyici Sürü**— Eş zamanlı yeniden deneme fırtınalarına karşı Mutex + semafor koruması
-**Birleşik Geri Dönüş Zincirleri**— Birincil sağlayıcı başarısız olursa, hiçbir müdahale olmadan otomatik olarak zincirden düşer
-**Kombo Devre Kesici**— Birleşik zincir içindeki arızalı sağlayıcıları otomatik olarak devre dışı bırakır
-**Sağlık Kontrol Paneli**— Çalışma süresi izleme, devre kesici durumları, kilitlenmeler, önbellek istatistikleri, p50/p95/p99 gecikmesi</details>

<detaylar>
<summary><b>🔧 7. "Her bir AI aracını yapılandırmak yorucu ve tekrarlayıcıdır"</b></summary>

Geliştiriciler Cursor, Claude Code, Codex CLI, OpenClaw, Gemini CLI, Kilo Code... Her aracın farklı bir yapılandırmaya (API uç noktası, anahtar, model) ihtiyacı vardır. Sağlayıcıları veya modelleri değiştirirken yeniden yapılandırmak zaman kaybıdır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**CLI Araçları Kontrol Paneli**— Claude Code, Codex CLI, OpenClaw, Kilo Code, Antigravity, Cline için tek tıklamayla kurulum sağlayan özel sayfa
-**GitHub Copilot Config Generator**— Toplu model seçimiyle VS Kodu için `chatLanguageModels.json` oluşturur
-**İlk Katılım Sihirbazı**— İlk kez kullananlar için kılavuzlu 4 adımlı kurulum
-**Tek uç nokta, tüm modeller**— `http://localhost:20128/v1`'i bir kez yapılandırın, 60'tan fazla sağlayıcıya erişin</details>

<detaylar>
<summary><b>🔑 8. "Birden fazla sağlayıcıdan gelen OAuth jetonlarını yönetmek cehennemdir"</b></summary>

Claude Code, Codex, Gemini CLI, Copilot — hepsi süresi dolan jetonlarla OAuth 2.0 kullanıyor. Geliştiricilerin sürekli olarak yeniden kimlik doğrulaması yapması, "client_secret eksik", "redirect_uri_mismatch" ve uzak sunuculardaki arızalarla uğraşması gerekir. LAN/VPS'de OAuth özellikle sorunludur.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Otomatik Belirteç Yenileme**— OAuth belirteçleri, geçerlilik süresi dolmadan arka planda yenilenir
-**OAuth 2.0 (PKCE) Yerleşik**— Claude Code, Codex, Gemini CLI, Copilot, Kiro, Qwen, Qoder için otomatik akış
-**Çoklu Hesap OAuth**— JWT/ID belirteci çıkarma yoluyla sağlayıcı başına birden fazla hesap
-**OAuth LAN/Remote Fix**— "redirect_uri" için özel IP algılama + uzak sunucular için manuel URL modu
-**Nginx'in Arkasında OAuth**— Ters proxy uyumluluğu için `window.location.origin'i kullanır
-**Uzaktan OAuth Kılavuzu**— VPS/Docker'da Google Cloud kimlik bilgileri için adım adım kılavuz</details>

<detaylar>
<summary><b>📊 9. "Ne kadar harcadığımı veya nereye harcadığımı bilmiyorum"</b></summary>

Geliştiriciler birden fazla ücretli sağlayıcı kullanıyor ancak harcamalara ilişkin birleşik bir görünüme sahip değiller. Her sağlayıcının kendi faturalandırma kontrol paneli vardır ancak birleştirilmiş görünüm yoktur. Beklenmedik maliyetler birikebilir.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Maliyet Analitiği Kontrol Paneli**— Sağlayıcı başına jeton başına maliyet takibi ve bütçe yönetimi
-**Kademe Başına Bütçe Sınırları**— Otomatik geri dönüşü tetikleyen, kademe başına harcama tavanı
-**Model Başına Fiyatlandırma Yapılandırması**— Model başına yapılandırılabilir fiyatlar
-**API Anahtarı Başına Kullanım İstatistikleri**— Anahtar başına istek sayısı ve son kullanılan zaman damgası
-**Analytics Kontrol Paneli**— İstatistik kartları, model kullanım tablosu, başarı oranlarını ve gecikmeyi gösteren sağlayıcı tablosu</details>

<detaylar>
<summary><b>🐛 10. "Yapay zeka çağrılarındaki hataları ve sorunları teşhis edemiyorum"</b></summary>

Bir çağrı başarısız olduğunda geliştirici bunun bir hız limiti mi, süresi dolmuş bir jeton mu, yanlış format mı yoksa sağlayıcı hatası mı olduğunu bilemez. Farklı terminallerde parçalanmış günlükler. Gözlemlenebilirlik olmadığında hata ayıklama deneme yanılma yöntemiyle yapılır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Birleşik Günlük Kontrol Paneli**— 4 sekme: İstek Günlükleri, Proxy Günlükleri, Denetim Günlükleri, Konsol
-**Konsol Günlük Görüntüleyici**— Renk kodlu seviyelere, otomatik kaydırmaya, arama ve filtreye sahip gerçek zamanlı terminal tarzı görüntüleyici
-**SQLite Proxy Günlükleri**— Sunucu yeniden başlatıldığında hayatta kalan kalıcı günlükler
-**Çevirmen Oyun Alanı**— 4 hata ayıklama modu: Oyun Alanı (biçim çevirisi), Sohbet Test Cihazı (gidiş-dönüş), Test Cihazı (toplu), Canlı Monitör (gerçek zamanlı)
-**İstek Telemetrisi**— p50/p95/p99 gecikmesi + X-İstek Kimliği izleme
-**Döndürmeli Dosya Tabanlı Günlük Kaydı**— Uygulama günlükleri boyuta, saklama günlerine ve arşiv sayısına göre değişir; çağrı günlüğü yapıları, saklama günlerine ve dosya sayısına göre değişir
-**Sistem Bilgisi Raporu**— "npm run system-info", tüm ortamınızla (Node sürümü, OmniRoute sürümü, işletim sistemi, CLI araçları, Docker/PM2 durumu) "system-info.txt" dosyasını oluşturur. Anında önceliklendirme için sorunları bildirirken bunu ekleyin.</details>

<detaylar>
<summary><b>🏗️ 11. "Ağ geçidini dağıtmak ve sürdürmek karmaşıktır"</b></summary>

Farklı ortamlarda (yerel, VPS, Docker, bulut) bir AI proxy'yi kurmak, yapılandırmak ve sürdürmek yoğun emek gerektirir. Sabit kodlanmış yollar, dizinlerdeki "EACCES", bağlantı noktası çakışmaları ve platformlar arası yapılar gibi sorunlar sürtüşmeyi artırır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**npm global kurulumu**— `npm kurulumu -g omniroute && omniroute` — tamamlandı
-**Docker Çoklu Platform**— AMD64 + ARM64 yerel (Apple Silicon, AWS Graviton, Raspberry Pi)
-**Docker Compose Profilleri**— "temel" (CLI aracı yok) ve "cli" (Claude Code, Codex, OpenClaw ile)
-**Electron Masaüstü Uygulaması**— Windows/macOS/Linux için sistem tepsisi, otomatik başlatma, çevrimdışı mod içeren yerel uygulama
-**Bölünmüş Bağlantı Noktası Modu**— Gelişmiş senaryolar için ayrı bağlantı noktalarında API ve Kontrol Paneli (ters proxy, konteyner ağı)
-**Bulut Senkronizasyonu**— Cloudflare Workers aracılığıyla cihazlar arasında senkronizasyonu yapılandırın
-**DB Yedeklemeleri**— Harici olarak yönetilen yedeklemeler için "DISABLE_SQLITE_AUTO_BACKUP" ile tüm ayarların otomatik olarak yedeklenmesi, geri yüklenmesi, dışa ve içe aktarılması</details>

<detaylar>
<summary><b>🌍 12. "Arayüz yalnızca İngilizcedir ve ekibim İngilizce konuşmuyor"</b></summary>

İngilizce konuşulmayan ülkelerdeki, özellikle Latin Amerika, Asya ve Avrupa'daki takımlar, yalnızca İngilizce arayüzlerde sorun yaşıyor. Dil engelleri benimsemeyi azaltır ve yapılandırma hatalarını artırır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Dashboard i18n — 30 Dil**— Arapça, Bulgarca, Danca, Almanca, İspanyolca, Fince, Fransızca, İbranice, Hintçe, Macarca, Endonezce, İtalyanca, Japonca, Korece, Malayca, Felemenkçe, Norveççe, Lehçe, Portekizce (PT/BR), Rumence, Rusça, Slovakça, İsveççe, Tayca, Ukraynaca, Vietnamca, Çince, Filipince, İngilizce dahil olmak üzere 500'den fazla anahtarın tümü çevrildi
-**RTL Desteği**— Arapça ve İbranice için sağdan sola destek
-**Çok Dilli README'ler**— 30 tam belge çevirisi
-**Dil Seçici**— Gerçek zamanlı geçiş için başlıktaki küre simgesi</details>

<detaylar>
<summary><b>🔄 13. "Sohbetten daha fazlasına ihtiyacım var; yerleştirmelere, resimlere ve sese ihtiyacım var"</b></summary>

Yapay zeka yalnızca sohbetin tamamlanması değildir. Geliştiricilerin görüntüler oluşturması, sesi yazıya dökmesi, RAG için yerleştirmeler oluşturması, belgeleri yeniden sıralaması ve içeriği denetlemesi gerekiyor. Her API'nin farklı bir uç noktası ve biçimi vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Yerleştirmeler**— 6 sağlayıcı ve 9'dan fazla modelle `/v1/yerleştirmeler`
-**Görüntü Oluşturma**— 10 sağlayıcı ve 20'den fazla modelle (OpenAI, xAI, Together, Fireworks, Nebius, Hyperbolik, NanoBanana, Antigravity, SD WebUI, ComfyUI) `/v1/images/ Generations`
-**Metinden Videoya**— `/v1/videos/ Generations` — ComfyUI (AnimateDiff, SVD) ve SD WebUI
-**Metinden Müziğe**— `/v1/music/ Generations` — ComfyUI (Stable Audio Open, MusicGen)
-**Ses Transkripsiyonu**— `/v1/audio/transcriptions` — Whisper + Nvidia NIM, HuggingFace, Qwen3
-**Metin-Konuşma**— `/v1/audio/speech` — ElevenLabs, Nvidia NIM, HuggingFace, Coqui, Tortoise, Qwen3,**Inworld**,**Cartesia**,**PlayHT**, + mevcut sağlayıcılar
-**Denetlemeler**— `/v1/moderations` — İçerik güvenliği kontrolleri
-**Yeniden sıralama**— `/v1/rerank` — Belge alaka düzeyinin yeniden sıralaması
-**Responses API**— Codex için tam `/v1/responses` desteği</details>

<detaylar>
<summary><b>🧪 14. "Kaliteyi modeller arasında test etme ve karşılaştırma yöntemim yok"</b></summary>

Geliştiriciler kendi kullanım durumları için hangi modelin (kod, çeviri, akıl yürütme) en iyi olduğunu bilmek isterler ancak manuel olarak karşılaştırma yapmak yavaştır. Entegre değerlendirme aracı mevcut değildir.

**OmniRoute bu sorunu nasıl çözüyor:**

-**LLM Değerlendirmeleri**— Selamlama, matematik, coğrafya, kod oluşturma, JSON uyumluluğu, çeviri, indirim, güvenlik reddini kapsayan önceden yüklenmiş 10 vakayla altın set testi
-**4 Eşleşme Stratejisi**— "tam", "içerir", "regex", "özel" (JS işlevi)
-**Translator Playground Test Bench**— Çoklu giriş ve beklenen çıktılarla toplu test, sağlayıcılar arası karşılaştırma
-**Sohbet Test Cihazı**— Görsel yanıt oluşturmayla tam gidiş-dönüş
-**Canlı İzleme**— Proxy üzerinden akan tüm isteklerin gerçek zamanlı akışı</details>

<detaylar>
<summary><b>📈 15. "Performansı kaybetmeden ölçeklendirmem gerekiyor"</b></summary>

İstek hacmi büyüdükçe, aynı soruları önbelleğe almamak, mükerrer maliyetlere neden olur. Belirsizlik olmadan, yinelenen istekler atık işlemeyi gerektirir. Sağlayıcı başına ücret sınırlarına uyulmalıdır.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Anlamsal Önbellek**— İki katmanlı önbellek (imza + anlamsal), maliyeti ve gecikmeyi azaltır
-**Talep Idempotency**— Aynı istekler için 5 saniyelik veri tekilleştirme penceresi
-**Hız Limiti Tespiti**— Sağlayıcı başına RPM, minimum aralık ve maksimum eşzamanlı izleme
-**Düzenlenebilir Hız Sınırları**— Ayarlar'da yapılandırılabilir varsayılanlar → Kalıcı dayanıklılık
-**API Anahtar Doğrulama Önbelleği**— Üretim performansı için 3 katmanlı önbellek
-**Telemetri Özellikli Sağlık Kontrol Paneli**— p50/p95/p99 gecikmesi, önbellek istatistikleri, çalışma süresi</details>

<detaylar>
<summary><b>🤖 16. "Model davranışını genel olarak kontrol etmek istiyorum"</b></summary>

Tüm yanıtların belirli bir dilde, belirli bir tonda olmasını isteyen veya akıl yürütme belirteçlerini sınırlamak isteyen geliştiriciler. Bunu her araçta/istekte yapılandırmak pratik değildir.

**OmniRoute bu sorunu nasıl çözüyor:**

-**Sistem İstemi Ekleme**— Tüm isteklere genel istem uygulandı
-**Bütçe Doğrulamasını Düşünme**— İstek başına jeton tahsis kontrolünün akıl yürütmesi (geçişli, otomatik, özel, uyarlanabilir)
-**9 Yönlendirme Stratejileri**— İsteklerin nasıl dağıtılacağını belirleyen genel stratejiler
-**Wildcard Router**— `sağlayıcı/*' kalıpları herhangi bir sağlayıcıya dinamik olarak yönlendirir
-**Kombo Etkinleştirme/Devre Dışı Geçişi**— Kombinasyonları doğrudan kontrol panelinden değiştirin
-**Sağlayıcı Geçişi**— Bir sağlayıcı için tüm bağlantıları tek tıklamayla etkinleştirin/devre dışı bırakın
-**Engellenen Sağlayıcılar**— Belirli sağlayıcıları `/v1/models` listesinden hariç tutun</details>

<detaylar>
<summary><b>🧰 17. "Birinci sınıf ürün özellikleri olarak MCP araçlarına ihtiyacım var"</b></summary>

Birçok AI ağ geçidi, MCP'yi yalnızca gizli bir uygulama ayrıntısı olarak açığa çıkarır. Ekiplerin görünür ve yönetilebilir bir operasyon katmanına ihtiyacı vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

- MCP, kontrol panelinde gezinme ve uç nokta protokolü sekmesinde görünür
- Süreç, araçlar, kapsamlar ve denetimin yer aldığı özel MCP yönetimi sayfası
- 'omniroute --mcp' ve istemci katılımı için yerleşik hızlı başlangıç</details>

<detaylar>
<summary><b>🧠 18. "Senkronizasyon + akış görev yollarıyla A2A orkestrasyonuna ihtiyacım var"</b></summary>

Aracı iş akışları, hem doğrudan yanıtlara hem de yaşam döngüsü kontrolüyle uzun süreli akışlı yürütmeye ihtiyaç duyar.

**OmniRoute bu sorunu nasıl çözüyor:**

- "mesaj/gönder" ve "mesaj/akış" ile A2A JSON-RPC uç noktası ("POST /a2a")
- Terminal durumu yayılımıyla SSE akışı
- "görevler/al" ve "görevler/iptal" için görev yaşam döngüsü API'leri</details>

<detaylar>
<summary><b>🛰️ 19. "Tahmin edilen duruma değil, gerçek MCP süreç durumuna ihtiyacım var"</b></summary>

Operasyonel ekiplerin yalnızca bir API'nin erişilebilir olup olmadığını değil, MCP'nin gerçekten hayatta olup olmadığını bilmesi gerekir.

**OmniRoute bu sorunu nasıl çözüyor:**

- PID, zaman damgaları, aktarım, araç sayısı ve kapsam modunu içeren çalışma zamanı kalp atışı dosyası
- Kalp atışı + son etkinliği birleştiren MCP durum API'si
- Süreç/çalışma süresi/kalp atışı tazeliği için kullanıcı arayüzü durum kartları</details>

<detaylar>
<summary><b>📋 20. "Denetlenebilir MCP aracı uygulamasına ihtiyacım var"</b></summary>

Araçlar yapılandırmayı değiştirdiğinde veya operasyon eylemlerini tetiklediğinde ekiplerin adli izlenebilirliğe ihtiyacı vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

- MCP aracı çağrıları için SQLite destekli denetim günlüğü
- Araç, başarı/başarısızlık, API anahtarı ve sayfalandırmaya göre filtreler
- Otomasyon için kontrol paneli denetim tablosu + istatistik uç noktaları</details>

<detaylar>
<summary><b>🔐 21. "Entegrasyon başına kapsamlı MCP izinlerine ihtiyacım var"</b></summary>

Farklı istemcilerin araç kategorilerine en az ayrıcalıklı erişime sahip olması gerekir.

**OmniRoute bu sorunu nasıl çözüyor:**

- Kontrollü araç erişimi için 10 ayrıntılı MCP kapsamı
- MCP yönetimi kullanıcı arayüzünde kapsam uygulaması ve görünürlük
- Operasyonel takımlama için güvenli varsayılan duruş</details>

<detaylar>
<summary><b>⚙️ 22. "Yeniden dağıtım yapmadan operasyonel kontrollere ihtiyacım var"</b></summary>

Ekiplerin olaylar veya maliyet olayları sırasında hızlı çalışma süresi değişikliklerine ihtiyacı vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

- Birleşik aktivasyonu doğrudan MCP kontrol panelinden değiştirin
- Önceden tanımlanmış politika paketlerinden dayanıklılık profillerini uygulayın
- Aynı işlem panelinden devre kesici durumunu sıfırlayın</details>

<detaylar>
<summary><b>🔄 23. "Canlı A2A görevi yaşam döngüsü görünürlüğüne ve iptaline ihtiyacım var"</b></summary>

Yaşam döngüsü görünürlüğü olmadan görev olaylarının önceliklendirilmesi zorlaşır.

**OmniRoute bu sorunu nasıl çözüyor:**

- Sayfalandırmayla duruma/beceriye göre görev listeleme/filtreleme
- Görev meta verileri, olaylar ve yapılar üzerinde ayrıntılı inceleme
- Onay ile görev iptali uç noktası ve kullanıcı arayüzü eylemi</details>

<detaylar>
<summary><b>🌊 24. "A2A yükü için aktif akış ölçümlerine ihtiyacım var"</b></summary>

Akış iş akışları, eşzamanlılık ve canlı bağlantılara ilişkin operasyonel bilgiler gerektirir.

**OmniRoute bu sorunu nasıl çözüyor:**

- A2A durumuna entegre edilmiş aktif akış sayaçları
- Son görev zaman damgası ve eyalet başına sayımlar
- Gerçek zamanlı operasyonların izlenmesi için A2A kontrol paneli kartları</details>

<detaylar>
<summary><b>🪪 25. "Müşteriler için standart aracı keşfine ihtiyacım var"</b></summary>

Harici istemciler ve orkestratörlerin katılım için makine tarafından okunabilir meta verilere ihtiyacı vardır.

**OmniRoute bu sorunu nasıl çözüyor:**

- Temsilci Kartı `/.well-known/agent.json` adresinde gösteriliyor
- Yönetim kullanıcı arayüzünde gösterilen yetenekler ve beceriler
- A2A durum API'si otomasyon için keşif meta verilerini içerir</details>

<detaylar>
<summary><b>🧭 26. "Ürün kullanıcı deneyiminde protokolün keşfedilebilirliğine ihtiyacım var"</b></summary>

Kullanıcılar protokol yüzeylerini keşfedemezse benimseme ve destek kalitesi düşer.

**OmniRoute bu sorunu nasıl çözüyor:**

- Proxy, MCP, A2A ve API Uç Noktaları sekmelerini içeren birleştirilmiş**Uç Noktalar**sayfası
- MCP ve A2A için hat içi hizmet durumu geçişleri (Çevrimiçi/Çevrimdışı)
- Genel bakıştan özel yönetim sekmelerine bağlantılar</details>

<detaylar>
<summary><b>🧪 27. "Gerçek istemcilerle uçtan uca protokol doğrulamaya ihtiyacım var"</b></summary>

Deneme testleri, yayınlanmadan önce protokol uyumluluğunu doğrulamak için yeterli değildir.

**OmniRoute bu sorunu nasıl çözüyor:**

- Uygulamayı başlatan ve gerçek MCP SDK istemci aktarımını kullanan E2E paketi
- Akışları keşfetme, gönderme, yayınlama, alma ve iptal etme için A2A istemci testleri
- MCP denetimi ve A2A görevleri API'lerine karşı iddiaları çapraz kontrol edin</details>

<detaylar>
<summary><b>📡 28. "Tüm arayüzlerde birleşik gözlemlenebilirliğe ihtiyacım var"</b></summary>

Gözlemlenebilirliğin protokole göre bölünmesi, kör noktalar ve daha uzun MTTR oluşturur.

**OmniRoute bu sorunu nasıl çözüyor:**

- Tek bir üründe birleştirilmiş kontrol panelleri/günlükler/analizler
- OpenAI, MCP ve A2A katmanlarında sağlık + denetim + istek telemetrisi
- Durum ve otomasyon için operasyonel API'ler</details>

<detaylar>
<summary><b>💼 29. "Proxy + araçlar + aracı orkestrasyonu için bir çalışma zamanına ihtiyacım var"</b></summary>

Birçok ayrı hizmetin çalıştırılması operasyonel maliyeti ve arıza türlerini artırır.

**OmniRoute bu sorunu nasıl çözüyor:**

- OpenAI uyumlu proxy, MCP sunucusu ve A2A sunucusu tek bir yığında
- Paylaşılan kimlik doğrulama, esneklik, veri deposu ve gözlemlenebilirlik
- Tüm etkileşim yüzeylerinde tutarlı politika modeli</details>

<detaylar>
<summary><b>🚀 30. "Yapıştırıcı kodun yayılması olmadan ajansal iş akışları göndermem gerekiyor"</b></summary>

Ekipler birden fazla geçici hizmeti ve komut dosyasını birleştirirken hız kaybeder.

**OmniRoute bu sorunu nasıl çözüyor:**

- Müşteriler ve temsilciler için birleşik uç nokta stratejisi
- Yerleşik protokol yönetimi kullanıcı arayüzleri ve duman doğrulama yolları
- Üretime hazır temeller (güvenlik, günlük kaydı, esneklik, yedekleme)</details>

### Example Playbooks (Integrated Use Cases)

**Başucu Kitabı A: Ücretli aboneliği en üst düzeye çıkarın + ucuz yedekleme**```txt
Combo: "maximize-claude"
  1. cc/claude-opus-4-6
  2. glm/glm-4.7
  3. if/kimi-k2-thinking

Monthly cost: $20 + small backup spend
Outcome: higher quality, near-zero interruption

Başucu Kitabı B: Sıfır maliyetli kodlama yığını```txt Combo: "free-forever"

gc/gemini-3-flash
if/kimi-k2-thinking
qw/qwen3-coder-plus

Monthly cost: $0 Outcome: stable free coding workflow


**Başucu Kitabı C: 7/24 her zaman açık geri dönüş zinciri**```txt
Combo: "always-on"
  1. cc/claude-opus-4-6
  2. cx/gpt-5.2-codex
  3. glm/glm-4.7
  4. minimax/MiniMax-M2.1
  5. if/kimi-k2-thinking

Outcome: deep fallback depth for deadline-critical workloads

Başucu Kitabı D: MCP + A2A ile ajan operasyonları```txt

Start MCP transport (omniroute --mcp) for tool-driven operations
Run A2A tasks via message/send and message/stream
Observe via /dashboard/endpoint (MCP and A2A tabs)
Toggle services via inline status controls


---

## 🆓 Start Free — Zero Configuration Cost

>**0$/ay**karşılığında AI kodlamasını dakikalar içinde kurun. Bu ücretsiz hesapları bağlayın ve yerleşik**Free Stack**kombinasyonunu kullanın.

| Adım | Eylem | Sağlayıcıların Kilidi Açıldı |
| ---- | -------------------------------------------------- | ------------------------------------------------------------------ |
| 1 |**Kiro**'yu bağlayın (AWS Builder ID OAuth) | Claude Sonnet 4.5, Haiku 4.5 —**sınırsız**|
| 2 |**Qoder**'a bağlanın (Google OAuth) | kimi-k2-düşünme, qwen3-kodlayıcı-artı, deepseek-r1... —**sınırsız**|
| 3 |**Qwen**'i bağlayın (Cihaz Kodu) | qwen3-coder-plus, qwen3-coder-flash... —**sınırsız**|
| 4 |**Gemini CLI**'yi (Google OAuth) bağlayın | gemini-3-flash, gemini-2.5-pro —**180K/ay ücretsiz**|
| 5 | `/dashboard/combos` →**Ücretsiz Yığın ($0)**şablon | Tüm ücretsiz sağlayıcıları otomatik olarak sıralayın |

**Herhangi bir IDE/CLI'yi şuraya yönlendirin:**`http://localhost:20128/v1` · API Anahtarı: `any-string` · Bitti.

>**İsteğe bağlı ekstra kapsam (ayrıca ücretsiz):**Groq API anahtarı (30 RPM ücretsiz), NVIDIA NIM (40 RPM ücretsiz, 70'den fazla model), Cerebras (1 milyon tok/gün), LongCat API anahtarı (50 milyon jeton/gün!), Cloudflare Workers AI (10 bin nöron/gün, 50'den fazla model).## Hızlı Başlangıç

### 1) Install and run

```bash
npm install -g omniroute
omniroute

pnpm kullanıcıları:"better-sqlite3" ve "@swc/core" tarafından gereken yerel derleme komut dosyalarını etkinleştirmek için kurulumdan sonra "pnpm onay-builds -g" komutunu çalıştırın:
pnpm install -g omniroute
pnpm onayla-derlemeler -g # Tüm paketleri seç → onayla
çok yönlü

Kontrol paneli "http://localhost:20128" konumunda açılır ve API temel URL'si "http://localhost:20128/v1" olur.

Komut	Açıklama
'çok yönlü'	Sunucuyu başlatın (`PORT=20128`, API ve kontrol paneli aynı bağlantı noktasında)
'omniroute --port 3000'	Kurallı/API bağlantı noktasını 3000 olarak ayarlayın
'çok yönlü rota --mcp'	MCP sunucusunu başlatın (stdio aktarımı)
`çok yönlü rota --açık değil'	Tarayıcıyı otomatik olarak açma
`çok yönlü rota --yardım'	Yardımı göster

İsteğe bağlı bölünmüş bağlantı noktası modu:```bash PORT=20128 DASHBOARD_PORT=20129 omniroute

API: http://localhost:20128/v1

Dashboard: http://localhost:20129


### Long-Running Streaming Timeouts

Çoğu dağıtım için yalnızca şunlara ihtiyacınız vardır:

| Değişken | Varsayılan | Amaç |
| ------------------------ | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `REQUEST_TIMEOUT_MS` | '600000' | Yukarı akış getirme, gizli Undici zaman aşımları, TLS parmak izi istekleri ve API köprüsü isteği/proxy zaman aşımları için paylaşılan temel |
| `STREAM_IDLE_TIMEOUT_MS` | `REQUEST_TIMEOUT_MS`yi devralır | OmniRoute SSE akışını iptal etmeden önce akış parçaları arasındaki maksimum boşluk |

Geriye dönük uyumluluk korunur: mevcut "FETCH_TIMEOUT_MS", "API_BRIDGE_PROXY_TIMEOUT_MS" ve katman başına diğer zaman aşımı değişkenleri çalışmaya devam eder ve paylaşılan temel çizgiyi geçersiz kılar.

Daha hassas kontrole ihtiyacınız varsa gelişmiş geçersiz kılmalar mevcuttur:| Değişken | Varsayılan | Amaç |
| ---------------------------------------- | ------------------------------- | -------------------------------------------------------------------- |
| `FETCH_TIMEOUT_MS` | `REQUEST_TIMEOUT_MS`yi devralır | Ana alma iptal sinyali tarafından kullanılan toplam yukarı akış isteği zaman aşımı |
| `FETCH_HEADERS_TIMEOUT_MS` | `FETCH_TIMEOUT_MS`yi devralır | Yukarı akış yanıt başlıklarını almak için süre sınırı |
| `FETCH_BODY_TIMEOUT_MS` | `FETCH_TIMEOUT_MS`yi devralır | Yukarı akışlı gövde parçaları arasındaki süre sınırı ("0" bunu devre dışı bırakır) |
| `FETCH_CONNECT_TIMEOUT_MS` | '30000' | TCP bağlantısı zaman aşımına uğradı |
| `FETCH_KEEPALIVE_TIMEOUT_MS` | '4000' | Boşta kalma canlı tutma yuvası zaman aşımı |
| `TLS_CLIENT_TIMEOUT_MS` | `FETCH_TIMEOUT_MS`yi devralır | 'Wreq-js' aracılığıyla yapılan TLS parmak izi istekleri için zaman aşımı |
| `API_BRIDGE_PROXY_TIMEOUT_MS` | 'REQUEST_TIMEOUT_MS' veya '30000' değerini devralır | API bağlantı noktasından kontrol paneli bağlantı noktasına `/v1` proxy iletiminde zaman aşımı |
| `API_BRIDGE_SERVER_REQUEST_TIMEOUT_MS` | `max(API_BRIDGE_PROXY_TIMEOUT_MS, 300000)` | API köprü sunucusunda gelen istek zaman aşımı |
| `API_BRIDGE_SERVER_HEADERS_TIMEOUT_MS` | '60000' | API köprü sunucusunda gelen başlık zaman aşımı |
| `API_BRIDGE_SERVER_KEEPALIVE_TIMEOUT_MS` | '5000' | API köprü sunucusunda canlı tutma zaman aşımı |
| `API_BRIDGE_SERVER_SOCKET_TIMEOUT_MS` | '0' | API köprü sunucusunda soket hareketsizliği zaman aşımı ("0" bunu devre dışı bırakır) |

OmniRoute'u Nginx, Caddy, Cloudflare veya başka bir ters proxy'nin arkasında çalıştırıyorsanız proxy'nin olduğundan emin olun.
zaman aşımları aynı zamanda OmniRoute akış/getirme zaman aşımlarınızdan da daha yüksektir.### 2) Connect providers and create your API key

1. Kontrol Paneli → `Sağlayıcılar'ı açın ve en az bir sağlayıcıya (OAuth veya API anahtarı) bağlanın.
2. Kontrol Paneli → `Uç Noktalar'ı açın ve bir API anahtarı oluşturun.
3. (İsteğe bağlı) Kontrol Paneli → 'Kombolar'ı açın ve yedek zincirinizi ayarlayın.### 3) Point your coding tool to OmniRoute

```txt
Base URL: http://localhost:20128/v1
API Key:  [copy from Endpoint page]
Model:    if/kimi-k2-thinking (or any provider/model prefix)

Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, OpenClaw, OpenCode ve OpenAI uyumlu SDK'larla çalışır.### 4) Enable and validate protocols (v2.0)

MCP (araç odaklı işlemler için):```bash omniroute --mcp


Daha sonra MCP istemcinizi "stdio" üzerinden bağlayın ve aşağıdaki gibi araçları test edin:

- "omniroute_get_health"
- "çoklu rota_listesi_birleşimleri"

**A2A (temsilciden temsilciye iş akışları için):**```bash
curl http://localhost:20128/.well-known/agent.json

curl -X POST http://localhost:20128/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":"quickstart","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Give me a short quota summary."}]}}'

5) Validate everything end-to-end (recommended)

npm run test:protocols:e2e

Bu paket, gerçek MCP ve A2A istemci akışlarını çalışan bir uygulamaya göre doğrular.### Alternative: run from source

cp .env.example .env
npm install
PORT=20128 DASHBOARD_PORT=20129 NEXT_PUBLIC_BASE_URL=http://localhost:20129 npm run dev

Linux'u geçersiz kılın (`xbps-src` şablonu)

Void Linux kullanıcıları için 'xbps-src'yi kullanarak yerel bir paket oluşturabilirsiniz. Bu bloğu srcpkgs/omniroute/template olarak kaydedin:```bash

Template file for 'omniroute'

pkgname=omniroute version=3.4.1 revision=1 hostmakedepends="nodejs python3 make" depends="openssl" short_desc="Universal AI gateway with smart routing for multiple LLM providers" maintainer="zenobit zenobit@disroot.org" license="MIT" homepage="https://github.com/diegosouzapw/OmniRoute" distfiles="https://github.com/diegosouzapw/OmniRoute/archive/refs/tags/v${version}.tar.gz" checksum=009400afee90a9f32599d8fe734145cfd84098140b7287990183dde45ae2245b system_accounts="_omniroute" omniroute_homedir="/var/lib/omniroute" export NODE_ENV=production export npm_config_engine_strict=false export npm_config_loglevel=error export npm_config_fund=false export npm_config_audit=false

do_build() { # Determine target CPU arch for node-gyp local _gyp_arch case "$XBPS_TARGET_MACHINE" in aarch64*) _gyp_arch=arm64 ;; armv7*|armv6*) _gyp_arch=arm ;; i686*) _gyp_arch=ia32 ;; *) _gyp_arch=x64 ;; esac

# 1) Install all deps – skip scripts (no network in do_build, native modules
#    compiled separately below; better-sqlite3 is serverExternalPackage so
#    Next.js does not execute it during next build)
NODE_ENV=development npm ci --ignore-scripts

# 2) Build the Next.js standalone bundle
npm run build

# 3) Copy static assets into standalone
cp -r .next/static .next/standalone/.next/static
[ -d public ] && cp -r public .next/standalone/public || true

# 4) Compile better-sqlite3 native binding for the target architecture.
#    Use node-gyp directly so CC/CXX from xbps-src cross-toolchain are used
#    without npm altering them.
local _node_gyp=/usr/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js
(cd node_modules/better-sqlite3 && node "$_node_gyp" rebuild --arch="$_gyp_arch")

# 5) Place the compiled binding into the standalone bundle
local _bs3_release=.next/standalone/node_modules/better-sqlite3/build/Release
mkdir -p "$_bs3_release"
cp node_modules/better-sqlite3/build/Release/better_sqlite3.node "$_bs3_release/"

# 6) Remove arch-specific sharp bundles – upstream sets images.unoptimized=true
#    so sharp is not used at runtime; x64 .so files would break aarch64 strip
rm -rf .next/standalone/node_modules/@img

# 7) Copy pino runtime deps omitted by Next.js static analysis:
#    pino-abstract-transport – required by pino's worker thread
#    split2 – dep of pino-abstract-transport
#    process-warning – dep of pino itself
for _mod in pino-abstract-transport split2 process-warning; do
	cp -r "node_modules/$_mod" .next/standalone/node_modules/
done

}

do_check() { npm run test:unit }

do_install() { vmkdir usr/lib/omniroute/.next

vcopy .next/standalone/. usr/lib/omniroute/.next/standalone

# Prevent removal of empty Next.js app router dirs by the post-install hook
for _d in \
	.next/standalone/.next/server/app/dashboard \
	.next/standalone/.next/server/app/dashboard/settings \
	.next/standalone/.next/server/app/dashboard/providers; do
	touch "${DESTDIR}/usr/lib/omniroute/${_d}/.keep"
done

cat > "${WRKDIR}/omniroute" <<'EOF'

#!/bin/sh export PORT="${PORT:-20128}" export DATA_DIR="${DATA_DIR:-${XDG_DATA_HOME:-${HOME}/.local/share}/omniroute}" export LOG_TO_FILE="${LOG_TO_FILE:-false}" mkdir -p "${DATA_DIR}" exec node /usr/lib/omniroute/.next/standalone/server.js "$@" EOF vbin "${WRKDIR}/omniroute" }

post_install() { vlicense LICENSE }


</details>

---

## 🐳 Docker

OmniRoute, [Docker Hub'ında](https://hub.docker.com/r/diegosouzapw/omniroute) herkese açık bir Docker görüntüsü olarak mevcuttur.

**Hızlı çalışma:**```bash
docker run -d \
  --name omniroute \
  --restart unless-stopped \
  --stop-timeout 40 \
  -p 20128:20128 \
  -v omniroute-data:/app/data \
  diegosouzapw/omniroute:latest

Ortam dosyasıyla:```bash

Copy and edit .env first

cp .env.example .env

docker run -d
--name omniroute
--restart unless-stopped
--stop-timeout 40
--env-file .env
-p 20128:20128
-v omniroute-data:/app/data
diegosouzapw/omniroute:latest


**Docker Compose'u kullanma:**```bash
# Base profile (no CLI tools)
docker compose --profile base up -d

# CLI profile (Claude Code, Codex, OpenClaw built-in)
docker compose --profile cli up -d

Docker dağıtımları için kontrol paneli desteği artık "Kontrol Paneli → Uç Noktalar"da tek tıklamaylaCloudflare Hızlı Tüneliiçeriyor. İlk etkinleştirme, yalnızca gerektiğinde "cloudflared" indirmelerini etkinleştirir, geçerli "/v1" uç noktanıza geçici bir tünel başlatır ve oluşturulan "https://*.trycloudflare.com/v1" URL'sini doğrudan normal genel URL'nizin altında gösterir.

Notlar:

Hızlı Tünel URL'leri geçicidir ve her yeniden başlatmanın ardından değişir.
Hızlı Tüneller, OmniRoute veya konteyner yeniden başlatıldıktan sonra otomatik olarak geri yüklenmez. Gerektiğinde bunları kontrol panelinden yeniden etkinleştirin.
Yönetilen yükleme şu anda "x64" / "arm64" üzerinde Linux, macOS ve Windows'u desteklemektedir.
Yönetilen Hızlı Tüneller, kısıtlı kapsayıcı ortamlarında gürültülü QUIC UDP arabellek uyarılarını önlemek için varsayılan olarak HTTP/2 aktarımını kullanır. Farklı bir aktarım istiyorsanız CLOUDFLARED_PROTOCOL=quic veya auto seçeneğini ayarlayın.
Docker görüntüleri, sistem CA köklerini paketler ve bunları yönetilen "cloudflared"a iletir; bu, tünel konteynerin içinde önyükleme yaptığında TLS güven hatalarını önler.
SQLite WAL modunda çalışır. OmniRoute'un "storage.sqlite" dosyasındaki en son değişiklikleri yeniden kontrol edebilmesi için "docker stop"un bitmesine izin verilmelidir.
Birlikte verilen Compose dosyaları zaten 40 saniyelik bir durdurma yetkisiz kullanım süresi belirlemiştir. Görüntüyü doğrudan çalıştırıyorsanız, --stop-timeout 40 (veya benzeri) tutun, böylece manuel durdurmalar kapatma temizliğini kesintiye uğratmaz.
OmniRoute'un bir ikili dosyayı indirmek yerine mevcut bir ikili programı kullanmasını istiyorsanız CLOUDFLARED_BIN=/absolute/path/to/cloudflared ayarını yapın.

Docker Compose'u Caddy (HTTPS Auto-TLS) ile kullanma:

OmniRoute, Caddy'nin otomatik SSL provizyonu kullanılarak güvenli bir şekilde açığa çıkarılabilir. Alan adınızın DNS A kaydının sunucunuzun IP'sini gösterdiğinden emin olun.```yaml services: omniroute: image: diegosouzapw/omniroute:latest container_name: omniroute restart: unless-stopped volumes: - omniroute-data:/app/data environment: - PORT=20128 - NEXT_PUBLIC_BASE_URL=https://your-domain.com

caddy: image: caddy:latest container_name: caddy restart: unless-stopped ports: - "80:80" - "443:443" command: caddy reverse-proxy --from https://your-domain.com --to http://omniroute:20128

volumes: omniroute-data:


| Resim | Etiket | Boyut | Açıklama |
| ------------------------ | -------- | ------ | --------------------- |
| 'diegosouzapw/omniroute' | 'en son' | ~250MB | En son kararlı sürüm |
| 'diegosouzapw/omniroute' | '1.0.3' | ~250MB | Güncel sürüm |---

## 🖥️ Desktop App — Offline & Always-On

> 🆕**YENİ!**OmniRoute artık Windows, macOS ve Linux için**yerel masaüstü uygulaması**olarak mevcut.

OmniRoute'u bağımsız bir masaüstü uygulaması olarak çalıştırın; yerel modeller için terminal yok, tarayıcı yok, internet gerekmiyor. Elektron tabanlı uygulama şunları içerir:

- 🖥️**Yerel Pencere**— Sistem tepsisi entegrasyonuna sahip özel uygulama penceresi
- 🔄**Otomatik Başlat**— Sisteme giriş yapıldığında OmniRoute'u başlatın
- 🔔**Yerel Bildirimler**— Kota tükenmesi veya sağlayıcı sorunlarıyla ilgili uyarılar alın
- ⚡**Tek Tıklamayla Kurulum**— NSIS (Windows), DMG (macOS), AppImage (Linux)
- 🌐**Çevrimdışı Mod**— Birlikte verilen sunucuyla tamamen çevrimdışı çalışır### Hızlı Başlangıç

```bash
# Development mode
npm run electron:dev

# Build for your platform
npm run electron:build         # Current platform
npm run electron:build:win     # Windows (.exe)
npm run electron:build:mac     # macOS (.dmg) — x64 & arm64
npm run electron:build:linux   # Linux (.AppImage)

System Tray

OmniRoute simge durumuna küçültüldüğünde hızlı eylemlerle sistem tepsinizde yaşar:

Kontrol panelini aç
Sunucu bağlantı noktasını değiştirin
Uygulamadan çık

📖 Tüm belgeler: electron/README.md---

💰 Pricing at a Glance

Seviye	Sağlayıcı	Maliyet	Kota Sıfırlama	En İyisi
💳 ABONELİK	Claude Kodu (Pro)	20$/ay	5 saat + haftalık	Zaten abone oldum
	Kodeks (Artı/Pro)	20-200$/ay	5 saat + haftalık	OpenAI kullanıcıları
	İkizler CLI	ÜCRETSİZ	180K/ay + 1K/gün	Herkes!
	GitHub Yardımcı Pilotu	10-19$/ay	Aylık	GitHub kullanıcıları
🔑API ANAHTARI	NVIDIA NIM	ÜCRETSİZ(sonsuza kadar geliştirme)	~40 RPM	70'den fazla açık model
	Beyinler	ÜCRETSİZ(1 milyon tok/gün)	60K TPM / 30 RPM	Dünyanın en hızlısı
	Büyük	ÜCRETSİZ(30 RPM)	14,4K RPD	Ultra hızlı Lama/Gemma
	DeepSeek V3.2	1 milyon dolar başına 0,27 dolar/1,10 dolar	Yok	En iyi fiyat/kalite muhakemesi
	xAI Grok-4 Hızlı	1 milyon başına 0,20 ABD Doları/0,50 ABD Doları🆕	Yok	En hızlı + araç çağırma, ultra düşük
	xAI Grok-4 (standart)	1 milyon dolar başına 0,20 dolar/1,50 dolar 🆕	Yok	xAI'den akıl yürütme amiral gemisi
	Mistral	Ücretsiz deneme + ücretli	Hız sınırlı	Avrupa Yapay Zekası
	OpenRouter	Kullanım başına ödeme	Yok	100'den fazla model toplamı
💰 UCUZ	GLM-5 (Z.AI aracılığıyla) 🆕	0,5$/1 milyon $	Günlük 10:00	128K çıkış, en yeni amiral gemisi
	GLM-4.7	0,6 `/1 milyon`	Günlük 10:00	Bütçe yedekleme
	MiniMax M2.5 🆕	0,3 ABD Doları/1 milyon giriş	5 saatlik ilerleme	Muhakeme + aracılı görevler
	MiniMax M2.1	0,2$/1 milyon $	5 saatlik ilerleme	En ucuz seçenek
	Kimi K2.5 (Moonshot API) 🆕	Kullanım başına ödeme	Yok	Doğrudan Moonshot API erişimi
	Kimi K2	9$/ay düz	10 milyon token/ay	Tahmin edilebilir maliyet
🆓 ÜCRETSİZ	Kod	$0	Sınırsız	5 model sınırsız
	Qwen	$0	Sınırsız	4 model sınırsız
	Kiro	$0	Sınırsız	Claude Sonnet/Haiku (AWS Oluşturucusu)
	LongCat Flash-Lite 🆕	0$(50 milyon tok/gün 🔥)	1RPS	Dünyanın en büyük ücretsiz kotası
	Tozlaşma AI 🆕	$0(anahtara gerek yok)	1 talep/15s	GPT-5, Claude, DeepSeek, Lama 4
	Cloudflare Çalışanları Yapay Zeka 🆕	0$(10.000 Nöron/gün)	~150 solunum/gün	50'den fazla model, global üstünlük
	Scaleway AI 🆕	0$(toplam 1 milyon jeton)	Hız sınırlı	AB/GDPR, Qwen3 235B, Llama 70B	> 🆕Yeni modeller eklendi (Mart 2026):0,20$/0,50$/M fiyatla Grok-4 Fast ailesi (1143 ms ile karşılaştırıldı — Gemini 2.5 Flash'tan %30 daha hızlı), 128K çıkışlı Z.AI aracılığıyla GLM-5, MiniMax M2.5 akıl yürütme, DeepSeek V3.2 güncellenmiş fiyatlandırma, Moonshot doğrudan API aracılığıyla Kimi K2.5.

💡 0 ABD Doları Kombo Yığın — Tam Ücretsiz Kurulum:```

🆓 Ultimate Free Stack 2026 — 11 Providers, $0 Forever

Kiro (kr/) → Claude Sonnet/Haiku UNLIMITED Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 UNLIMITED LongCat Lite (lc/) → LongCat-Flash-Lite — 50M tokens/day 🔥 Pollinations (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — no key needed Qwen (qw/) → qwen3-coder-plus, qwen3-coder-flash, qwen3-coder-next UNLIMITED Gemini (gemini/) → Gemini 2.5 Flash — 1,500 req/day free API key Cloudflare AI (cf/) → Llama 70B, Gemma 3, Mistral — 10K Neurons/day Scaleway (scw/) → Qwen3 235B, Llama 70B — 1M free tokens (EU) Groq (groq/) → Llama/Gemma ultra-fast — 14.4K req/day NVIDIA NIM (nvidia/) → 70+ open models — 40 RPM forever Cerebras (cerebras/) → Llama/Qwen world-fastest — 1M tok/day


**Sıfır maliyet. Kodlamayı asla durdurmayın.**Bunu tek bir OmniRoute birleşimi olarak yapılandırdığınızda tüm geri dönüşler otomatik olarak gerçekleşir; hiçbir zaman manuel geçiş yapılmaz.---

---

## 🆓 Free Models — What You Actually Get

> Aşağıdaki tüm modeller**sıfır kredi kartı gerekliliğiyle %100 ücretsizdir**. OmniRoute, bir kota dolduğunda bunlar arasında otomatik yönlendirme yapar; kırılamaz 0 ABD doları değerinde bir kombinasyon için hepsini birleştirir.### 🔵 CLAUDE MODELS (via Kiro — AWS Builder ID)

| Modeli | Önek | Sınırı | Oran Limiti |
| ------------------- | ------ | ------------- | --------------------- |
| `claude-sonnet-4.5` | 'kr/' |**Sınırsız**| Günlük sınır bildirilmedi |
| `Claude-haiku-4.5` | 'kr/' |**Sınırsız**| Günlük sınır bildirilmedi |
| `Claude-opus-4.6` | 'kr/' |**Sınırsız**| Kiro aracılığıyla en son Opus |### 🟢 QODER MODELS (Free PAT via qodercli)

| Modeli | Önek | Sınırı | Oran Limiti |
| ------------------ | ------ | ------------- | --------------- |
| `kimi-k2-düşünme' | 'eğer/' |**Sınırsız**| Bildirilen sınır yok |
| `qwen3-kodlayıcı-artı` | 'eğer/' |**Sınırsız**| Bildirilen sınır yok |
| 'derin arama-r1' | 'eğer/' |**Sınırsız**| Bildirilen sınır yok |
| 'minimax-m2.1' | 'eğer/' |**Sınırsız**| Bildirilen sınır yok |
| 'kimi-k2' | 'eğer/' |**Sınırsız**| Bildirilen sınır yok |

> Önerilen bağlantı yöntemi:**Kişisel Erişim Simgesi + `qodercli`**. Tarayıcı OAuth'u (şimdiki değeri)
> `QODER_OAUTH_*` ortam değişkenleri yapılandırılmadığı sürece deneyseldir ve varsayılan olarak devre dışıdır.### 🟡 QWEN MODELS (Device Code Auth)

| Modeli | Önek | Sınırı | Oran Limiti |
| ------------------- | ------ | ------------- | ------------------- |
| `qwen3-kodlayıcı-artı` | 'qw/' |**Sınırsız**| Bildirilen sınır yok |
| `qwen3-kodlayıcı-flaş' | 'qw/' |**Sınırsız**| Bildirilen sınır yok |
| `qwen3-kodlayıcı-sonraki` | 'qw/' |**Sınırsız**| Bildirilen sınır yok |
| 'vizyon modeli' | 'qw/' |**Sınırsız**| Multimodal (resimler) |### 🟣 GEMINI CLI (Google OAuth)

| Modeli | Önek | Sınırı | Oran Limiti |
| ------------------------ | ------ | ---------------------------- | ------------- |
| 'ikizler-3-flash-önizleme' | 'gc/' |**180 bin tok/ay**+ 1 bin/gün | Aylık sıfırlama |
| 'ikizler-2.5-pro' | 'gc/' | 180K/ay (ortak havuz) | Yüksek kalite |### ⚫ NVIDIA NIM (Free API Key — build.nvidia.com)

| Seviye | Günlük Limit | Oran Limiti | Notlar |
| ---------- | ------------ | ----------- | -------------------------------------------- |
| Ücretsiz (Geliştirme) | Jeton sınırı yok |**~40 RPM**| 70+ model; 2025 ortalarında saf faiz limitlerine geçiş |

Popüler ücretsiz modeller: "moonshotai/kimi-k2.5" (Kimi K2.5), "z-ai/glm4.7" (GLM 4.7), "deepseek-ai/deepseek-v3.2" (DeepSeek V3.2), "nvidia/llama-3.3-70b-instruct", "deepseek/deepseek-r1"### ⚪ CEREBRAS (Free API Key — inference.cerebras.ai)

| Seviye | Günlük Limit | Oran Limiti | Notlar |
| ---- | ----------------- | ---------------- | --------------------------------- |
| Ücretsiz |**1 milyon token/gün**| 60K TPM / 30 RPM | Dünyanın en hızlı Yüksek Lisans çıkarımı; günlük olarak sıfırlanır |

Ücretsiz olarak mevcuttur: `llama-3.3-70b`, `llama-3.1-8b`, `deepseek-r1-distill-llama-70b`### 🔴 GROQ (Free API Key — console.groq.com)

| Seviye | Günlük Limit | Oran Limiti | Notlar |
| ---- | ------------- | ---------------- | ----------------------------------------- |
| Ücretsiz |**14,4K RPD**| Model başına 30 RPM | Kredi kartı yok; 429 limitli, ücret alınmadı |

Ücretsiz olarak mevcuttur: "llama-3.3-70b-versatile", "gemma2-9b-it", "mixtral-8x7b", "whisper-large-v3"### 🔴 LONGCAT AI (Free API Key — longcat.chat) 🆕

| Modeli | Önek | Günlük Ücretsiz Kota | Notlar |
| ----------------------------- | ------ | ----------------- | ----------------------- |
| 'LongCat-Flash-Lite' | 'lc/' |**50 milyon jeton**💥 | Şimdiye kadarki en büyük ücretsiz kota |
| 'LongCat-Flash-Sohbet' | 'lc/' | 500.000 jeton | Çok turlu sohbet |
| 'LongCat-Flash-Düşünme' | 'lc/' | 500.000 jeton | Muhakeme / CoT |
| 'LongCat-Flash-Düşünme-2601' | 'lc/' | 500.000 jeton | Ocak 2026 versiyonu |
| 'LongCat-Flash-Omni-2603' | 'lc/' | 500.000 jeton | Çok modlu |

> Herkese açık beta sürümünde %100 ücretsiz. [longcat.chat](https://longcat.chat) adresinden e-posta veya telefonla kaydolun. Günlük 00:00 UTC'yi sıfırlar.### 🟢 POLLINATIONS AI (No API Key Required) 🆕

| Modeli | Önek | Oran Limiti | Sağlayıcı Arkasında |
| ---------- | ------ | ---------- | ------------------ |
| 'açık' | 'pol/' | 1 talep/15s | GPT-5 |
| 'Claude' | 'pol/' | 1 talep/15s | Antropik Claude |
| 'İkizler' | 'pol/' | 1 talep/15s | Google İkizler |
| 'derin arama' | 'pol/' | 1 talep/15s | DeepSeek V3 |
| 'lama' | 'pol/' | 1 talep/15s | Meta Lama 4 İzci |
| 'mistral' | 'pol/' | 1 talep/15s | Mistral AI |

> ✨**Sıfır sürtünme:**Kayıt yok, API anahtarı yok. Tozlaşma sağlayıcısını boş bir anahtar alanıyla ekleyin ve hemen çalışır.### 🟠 CLOUDFLARE WORKERS AI (Free API Key — cloudflare.com) 🆕

| Seviye | Günlük Nöronlar | Eşdeğer Kullanım | Notlar |
| ---- | ------------- | --------------------------------------- | ----------------------- |
| Ücretsiz |**10.000**| ~150 Yüksek Lisans / 500s ses / 15K yerleştirme | Global uç, 50'den fazla model |

Popüler ücretsiz modeller: `@cf/meta/llama-3.3-70b-instruct`, `@cf/google/gemma-3-12b-it`, `@cf/openai/whisper-large-v3-turbo` (ücretsiz ses!), `@cf/qwen/qwen2.5-coder-15b-instruct`

> [dash.cloudflare.com](https://dash.cloudflare.com) adresinden API Jetonu + Hesap Kimliği gerektirir. Hesap Kimliğini sağlayıcı ayarlarında saklayın.### 🟣 SCALEWAY AI (1M Free Tokens — scaleway.com) 🆕

| Seviye | Ücretsiz Kota | Konum | Notlar |
| ---- | ------------- | ------------ | ----------------------------------- |
| Ücretsiz |**1 milyon jeton**| 🇫🇷 Paris, AB | Limitler dahilinde kredi kartına gerek yok |

Ücretsiz olarak mevcuttur: `qwen3-235b-a22b-instruct-2507` (Qwen3 235B!), `llama-3.1-70b-instruct`, `mistral-small-3.2-24b-instruct-2506`, `deepseek-v3-0324`

> AB/GDPR ile uyumludur. [console.scaleway.com](https://console.scaleway.com) adresinden API anahtarını alın.

>**💡 Ultimate Ücretsiz Yığın (11 Sağlayıcı, Sonsuza Kadar 0 ABD Doları):**
>
> ```
> Kiro (kr/) → Claude Sonnet/Haiku SINIRSIZ
> Qoder (if/) → kimi-k2-thinking, qwen3-coder-plus, deepseek-r1 SINIRSIZ
> LongCat Lite (lc/) → LongCat-Flash-Lite — 50 milyon jeton/gün 🔥
> Tozlaşma (pol/) → GPT-5, Claude, DeepSeek, Llama 4 — anahtara gerek yok
> Qwen (qw/) → qwen3 kodlayıcı modelleri SINIRSIZ
> Gemini (gemini/) → Gemini 2.5 Flash — 1.500 talep/gün ücretsiz
> Cloudflare AI (cf/) → 50'den fazla model — 10.000 Nöron/gün
> Scaleway (scw/) → Qwen3 235B, Llama 70B — 1 milyon ücretsiz token (AB)
> Groq (groq/) → Llama/Gemma — 14,4K talep/gün ultra hızlı
> NVIDIA NIM (nvidia/) → 70'ten fazla açık model — sonsuza kadar 40 RPM
> Cerebras (cerebras/) → Lama/Qwen dünyanın en hızlısı — 1 milyon tok/gün
> ```## 🎙️ Free Transcription Combo

> Herhangi bir sesi/videoyu**0$**karşılığında yazıya dökün — Deepgram 200$ ücretsiz, AssemblyAI 50$ geri dönüş ve sınırsız acil durum yedeklemesi olarak Groq Whisper ile önde gidiyor.

| Sağlayıcı | Ücretsiz Krediler | En İyi Model | Oran Limiti |
| ----------------- | ----------------------- | --------------------------------- | ---------------------------- |
| 🟢**Deepgram**|**200$ ücretsiz**(kayıt) | `nova-3` — en iyi doğruluk, 30'dan fazla dilde | Ücretsiz kredilerde RPM sınırı yok |
| 🔵**AssemblyAI**|**50$ ücretsiz**(kayıt) | `universal-3-pro` — bölümler, görüş, PII | Ücretsiz kredilerde RPM sınırı yok |
| 🔴**Groq**|**Sonsuza kadar ücretsiz**| "whisper-large-v3" — OpenAI Whisper | 30 RPM (hız sınırlı) |

**`/dashboard/combos`ta önerilen kombinasyon:**```
Name: free-transcription
Strategy: Priority
Nodes:
  [1] deepgram/nova-3          → uses $200 free first
  [2] assemblyai/universal-3-pro → fallback when Deepgram credits run out
  [3] groq/whisper-large-v3    → free forever, emergency fallback

Daha sonra /dashboard/media →Transkripsiyonsekmesinde: herhangi bir ses veya video dosyasını yükleyin → birleşik uç noktanızı seçin → desteklenen formatlarda transkripsiyon alın.## 💡 Key Features

OmniRoute v2.0 yalnızca geçiş proxy'si değil, operasyonel bir platform olarak oluşturulmuştur.### 🆕 New — ClawRouter-Inspired Improvements (Mar 2026)

Özellik	Ne İşe Yarar
⚡Grok-4 Hızlı Ailesi	xAI modelleri 0,20 ABD Doları/0,50 ABD Doları/M seviyesinde — karşılaştırmalı 1143 ms (Gemini 2.5 Flash'tan %30 daha hızlı)
🧠Z.AI aracılığıyla GLM-5	128K çıktı bağlamı, 0,5 Milyon Dolar/1 Milyon Dolar — GLM ailesinin en yeni amiral gemisi
🔮MiniMax M2.5	Muhakeme + aracılı görevler 0,30 ABD Doları/1 Milyon Dolar — M2.1'e göre önemli bir artış
🎯Model başına toolCalling Flag	Kayıt defterinde her model için 'toolCalling: doğru/yanlış' — AutoCombo, araç özelliği olmayan modelleri atlar
🌍Çok Dilli Niyet Tespiti	AutoCombo puanlamada PT/ZH/ES/AR anahtar sözcükleri — İngilizce olmayan içerik için daha iyi model seçimi
📊Kıyaslama Odaklı Geri Dönüşler	Canlı isteklerden elde edilen gerçek p95 gecikmesi birleşik puanlamayı besler — AutoCombo gerçek verilerden öğrenir
🔁Tekilleştirme Talebi	İçerik karması tabanlı yinelenenleri kaldırma penceresi — çoklu aracı açısından güvenli, mükerrer ödemeleri önler
🔌Takılabilir YönlendiriciStrateji	Genişletilebilir `RouterStrategy` arayüzü — eklenti olarak özel yönlendirme mantığı ekleyin	### 🚀 Previous v2.0.9+ — Playground, CLI Fingerprints & ACP

Özellik	Ne İşe Yarar
🎮Model Oyun Alanı	Herhangi bir modeli doğrudan test etmek için kontrol paneli sayfası — sağlayıcı/model/uç nokta seçiciler, Monaco Düzenleyici, akış, iptal, zamanlama
🔏CLI Parmak İzi Eşleştirme	Yerel CLI imzalarıyla eşleşmek için sağlayıcı başına başlık/gövde sıralaması - Ayarlar > Güvenlik'te sağlayıcıya göre geçiş yapın.Proxy IP'niz korunur
🤝ACP Desteği (Ajan İstemci Protokolü)	CLI aracısı keşfi (Codex, Claude, Goose, Gemini CLI, OpenClaw + 9 tane daha), süreç oluşturucu, `/api/acp/agents' uç noktası
🤖ACP Temsilcileri Kontrol Paneli	Hata ayıklama › Aracılar sayfası — herhangi bir CLI aracı için yükleme durumu, sürüm ve özel aracı formunu içeren 14 aracıdan oluşan tablo.OpenCodekullanıcıları, mevcut tüm modellerle birlikte kullanıma hazır bir yapılandırmayı otomatik olarak oluşturan bir "opencode.json'u indir" düğmesine sahip olur.
🔧Özel Model `apiFormat` Yönlendirme	`apiFormat: "responses"` içeren özel modeller artık Responses API çeviricisine doğru şekilde yönlendiriliyor
🏢Codex Çalışma Alanı Yalıtımı	E-posta başına birden fazla Codex çalışma alanı — OAuth, bağlantıları çalışma alanı kimliğine göre doğru şekilde ayırır
🔄Elektron Otomatik Güncelleme	Masaüstü uygulaması güncellemeleri kontrol eder + yeniden başlatıldığında otomatik yükleme	### 🤖 Agent & Protocol Operations (v2.0)

Özellik	Ne İşe Yarar
🔧MCP Sunucusu (25 araç)	3 aktarım yoluyla IDE/aracı araçları: stdio, SSE (`/api/mcp/sse`), Akış Yapılabilir HTTP (`/api/mcp/stream`). 18 çekirdek + 3 bellek + 4 beceri aracı
🤝A2A Sunucusu (JSON-RPC + SSE)	Senkronizasyon ve akış akışlarıyla aracıdan aracıya görev yürütme
🧭Birleştirilmiş Uç Noktalar Sayfası	Uç Nokta Proxy'si, MCP, A2A ve API Uç Noktaları sekmelerini içeren sekmeli yönetim sayfası
🎚️Hizmeti Etkinleştirme/Devre Dışı Bırakma Geçişleri	MCP ve A2A için ayarların kalıcı olduğu AÇIK/KAPALI anahtarlar (varsayılan: KAPALI)
🛰️MCP Çalışma Zamanı Kalp Atışı	Gerçek süreç durumu (pid, çalışma süresi, kalp atışı yaşı, aktarım, kapsam modu)
📋MCP Denetim Kaydı	Başarı/başarısızlık ve anahtar ilişkilendirme içeren filtrelenebilir denetim günlükleri
🔐MCP Kapsamının Uygulanması	Kontrollü araç erişimi için 10 ayrıntılı kapsam izni
📡A2A Görev Yaşam Döngüsü Yönetimi	Görevleri listeleyin/filtreleyin, olayları/yapıları inceleyin, çalışan görevleri iptal edin
📋Acente Kartı Keşfi	İstemcinin otomatik keşfi için `/.well-known/agent.json`
🧪Protokol E2E Test Donanımı	Gerçek MCP SDK + A2A istemcisi `test:protokoller:e2e`de akar
⚙️Operasyonel Kontroller	Tek bir kontrol yüzeyinden komboyu değiştirin, dayanıklılık profilleri uygulayın, kesicileri sıfırlayın	### 🧠 Routing & Intelligence

Özellik	Ne İşe Yarar
🎯Akıllı 4 Katmanlı Geri Dönüş	Otomatik yönlendirme: Abonelik → API Anahtarı → Ucuz → Ücretsiz
📊Gerçek Zamanlı Kota Takibi	Canlı token sayısı + sağlayıcı başına geri sayımı sıfırlayın
🔄Biçim Çevirisi	OpenAI ↔ Claude ↔ Gemini ↔ Şema güvenli dönüşümlerle yanıtlar
👥Çoklu Hesap Desteği	Akıllı seçimle sağlayıcı başına birden fazla hesap
🔄Otomatik Jeton Yenileme	OAuth belirteçleri yeniden denemeyle otomatik olarak yenilenir
🎨Özel Kombinasyonlar	9 dengeleme stratejisi + geri dönüş zinciri kontrolü
🌐Joker Karakter Yönlendirici	'sağlayıcı/*' dinamik yönlendirme
🧠Bütçe Kontrollerini Düşünmek	Geçiş, otomatik, özel ve uyarlanabilir akıl yürütme sınırları
🔀Model Takma Adları	Yerleşik + özel model örtüşme ve geçiş güvenliği
⚡Arka Plan Bozulması	Düşük öncelikli arka plan görevlerini daha ucuz modellere yönlendirin
🧪Göreve Duyarlı Akıllı Yönlendirme	Modeli içerik türüne göre otomatik seç (kodlama/vizyon/analiz/özetleme)
🔄A2A Temsilci İş Akışları	Durum bilgisi olan çok adımlı aracı yürütmeleri için deterministik FSM orkestratörü
🔀Uyarlanabilir Yönlendirme	Belirteç hacmine ve istem karmaşıklığına dayalı dinamik strateji geçersiz kılma
🎲Sağlayıcı Çeşitliliği	Shannon entropi puanlaması otomatik birleşik trafik dağıtımını dengeleme
💬Sistem İstemi Ekleme	Tutarlı bir şekilde uygulanan küresel davranış kontrolleri
📄Yanıtlar API Uyumluluğu	Codex ve gelişmiş aracılı iş akışları için tam `/v1/responses` desteği	### 🎵 Multi-Modal APIs

Özellik	Ne İşe Yarar
🖼️Görüntü Oluşturma	Bulut ve yerel arka uçlarla `/v1/images/ Generations`
📐Gömmeler	arama ve RAG ardışık düzenleri için `/v1/embeddings`
🎤Ses Transkripsiyonu	`/v1/audio/transcriptions` — 7 sağlayıcı (Deepgram Nova 3, AssemblyAI, Groq Whisper, HuggingFace, ElevenLabs, OpenAI, Azure), otomatik dil algılama, MP4/MP3/WAV desteği
🔊Metinden Konuşmaya	`/v1/audio/speech` — Doğru hata mesajlarına sahip 10 sağlayıcı (ElevenLabs, OpenAI, Deepgram, Cartesia, PlayHT, HuggingFace, Nvidia NIM, Inworld, Coqui, Tortoise)
🎬Video Oluşturma	`/v1/videos/ Generations` (ComfyUI + SD WebUI iş akışları)
🎵Müzik Üretimi	`/v1/music/jenerasyonlar` (ComfyUI iş akışları)
🛡️Denetimler	`/v1/moderations` güvenlik kontrolleri
🔀Yeniden sıralama	alaka puanlaması için `/v1/rerank`
🔍Web Araması🆕	`/v1/search` — 5 sağlayıcı (Serper, Brave, Perplexity, Exa, Tavily), 6.500'den fazla ücretsiz/ay, otomatik yük devretme, önbellek	### 🛡️ Resilience, Security & Governance

Özellik	Ne İşe Yarar
🔌Devre Kesiciler	Eşik kontrolleriyle model başına açma/kurtarma
🎯Uç Nokta Farkındalığı Olan Modeller	Özel modeller desteklenen uç noktaları + API formatını bildirir
🛡️Yıldırım Karşıtı Sürü	Yeniden deneme/oranlandırma olaylarında Mutex + semafor korumaları
🧠Anlamsal + İmza Önbelleği	İki önbellek katmanıyla maliyet/gecikme azalması
⚡İdempotentlik Talebi	Yinelenen koruma penceresi
🔒TLS Parmak İzi Sahtekarlığı	Tarayıcı benzeri TLS parmak izi —bot tespitini ve hesap işaretlemeyi azaltır
🔏CLI Parmak İzi Eşleştirme	Yerel CLI istek imzalarıyla eşleşir —proxy IP'sini korurken yasaklama riskini azaltır
🌐IP Filtreleme	Açığa çıkan dağıtımlar için izin verilenler listesi/engellenenler listesi kontrolü
📊Düzenlenebilir Oran Limitleri	Kalıcılıkla yapılandırılabilir küresel/sağlayıcı düzeyinde sınırlar
📉Zarif Bozulma	Çekirdek ağ geçidi işlemlerini koruyan çok katmanlı yetenek geri dönüşleri
📜Yapılandırma Denetim İzi	Basit geri alma işlemleriyle operasyonel sapmayı önleyen fark tabanlı değişiklik takibi
⏳Sağlayıcı Sağlık Senkronizasyonu	Yetkilendirme hatalarından önce uyarıları tetikleyen proaktif belirteç süre sonu izleme
🚪Yasaklı Hesapları Otomatik Devre Dışı Bırak	Operasyonel devre kesici, kalıcı olarak engellenen token hesaplarını otomatik olarak kapatıyor
🔑API Anahtar Yönetimi + Kapsam Belirleme	Güvenli anahtar verme/döndürme ve model/sağlayıcı kontrolleri
👁️Kapsamlı API Anahtarı Gösterimi🆕	API anahtarlarının "ALLOW_API_KEY_REVEAL" aracılığıyla kurtarılmasını etkinleştirme
🛡️Korumalı `/modeller`	Model kataloğu için isteğe bağlı kimlik doğrulama ve sağlayıcı gizleme	### 📊 Observability & Analytics

Özellik	Ne İşe Yarar
📝İstek + Proxy Günlüğü	Tam istek/yanıt ve proxy günlüğü
📉Akışlı Ayrıntılı Günlükler🆕	SSE verisi akışlarını kullanıcı arayüzüne temiz bir şekilde yeniden yapılandırır
📋Birleşik Günlükler Kontrol Paneli	Tek sayfada istek, proxy, denetim ve konsol görünümleri
🔍Telemetri İste	p50/p95/p99 gecikmesi ve istek takibi
🏥Sağlık Kontrol Paneli	Çalışma süresi, kesici durumları, kilitlenmeler, önbellek istatistikleri
💰Maliyet Takibi	Bütçe kontrolleri ve model başına fiyatlandırma görünürlüğü
📈Analitik Görselleştirmeler	Model/sağlayıcı kullanım bilgileri ve trend görünümleri
🧪Değerlendirme Çerçevesi	Yapılandırılabilir maç stratejileriyle altın set testi
📡Canlı Teşhis🆕	Doğru birleşik canlı test için semantik önbellek atlama	### ☁️ Deployment & Platform

Özellik	Ne İşe Yarar
🌐Her Yere Dağıtın	Localhost, VPS, Docker, Bulut ortamları
🚇Cloudflare Tüneli🆕	Kontrol panelinden tek tıklamayla Hızlı Tünel entegrasyonu
🔑API Anahtar Modeli Filtreleme	Yerel /v1/models yanıtı, atanmış Taşıyıcı bağlam rolleri aracılığıyla filtrelendi
⚡Akıllı Önbellek Atlaması	Yapılandırılabilir TTL buluşsal yöntemi ve zorunlu yeniden getirme kontrolleri
🔄Yedekle/Geri Yükle	İhracat/ithalat ve olağanüstü durum kurtarma akışları
🧙İlk Katılım Sihirbazı	İlk çalıştırmada kılavuzlu kurulum
🔧CLI Araçları Kontrol Paneli	Popüler kodlama araçları için tek tıkla kurulum
🎮Model Oyun Alanı	Kontrol panelinden herhangi bir sağlayıcıyı/modeli/uç noktayı test edin
🔏CLI Parmak İzi Geçişi	Ayarlar > Güvenlik	Sağlayıcıya göre parmak izi eşleştirme
🌐i18n (30 dil)	Tam kontrol paneli + RTL kapsamıyla belge dili desteği
🧹Tüm Modelleri Temizle	Sağlayıcı ayrıntılarında tek tıklamayla model listesi temizleme
👁️Kenar Çubuğu Kontrolleri🆕	Görünüm Ayarları'ndan bileşenleri ve entegrasyonları gizleyin
📋Sayı Şablonları	Hatalar ve özellikler için standartlaştırılmış GitHub şablonları
📂Özel Veri Dizini	Depolama konumu için `DATA_DIR` geçersiz kılma	### Feature Deep Dive

Smart fallback with practical cost control

Combo: "my-coding-stack"
  1. cc/claude-opus-4-6
  2. nvidia/llama-3.3-70b
  3. glm/glm-4.7
  4. if/kimi-k2-thinking

Kota, oran veya sağlık başarısız olduğunda OmniRoute, manuel geçişe gerek kalmadan otomatik olarak bir sonraki adaya geçer.#### Protocol management that is visible and operable

MCP + A2A, kullanıcı arayüzünde ve belgelerde keşfedilebilir (gizli değil)
Protokol durumu API'leri canlı operasyonel verileri açığa çıkarır (/api/mcp/*, /api/a2a/*)
Kontrol panelleri 2. gün operasyonlarına yönelik eylemleri içerir (kombo geçişler, devre kesici sıfırlamaları, görev iptali)#### Translator + validation workflow

Çevirmen alanı şunları içerir:

-Oyun Alanı: dönüşüm kontrolleri isteyin -Sohbet Test Cihazı: tam istek/yanıt gidiş-dönüş -Test Tezgahı: tek çalıştırmada birden fazla vaka -Canlı Monitör: gerçek zamanlı trafik görünümü

Ayrıca "npm çalıştırma testi:protokoller:e2e" aracılığıyla gerçek istemcilerle protokol doğrulama.

📖MCP Sunucusu README— Araç referansı, IDE yapılandırmaları ve istemci örnekleri

📖A2A Sunucusu README— Beceriler, JSON-RPC yöntemleri, akış ve görev yaşam döngüsü## 🧪 Evaluations (Evals)

OmniRoute, LLM yanıt kalitesini altın bir sete göre test etmek için yerleşik bir değerlendirme çerçevesi içerir. Kontrol panelindekiAnalytics → Evalsaracılığıyla bu bilgilere erişin.### Built-in Golden Set

Önceden yüklenmiş "OmniRoute Golden Set" aşağıdakiler için test senaryoları içerir:

Selamlar, matematik, coğrafya, kod oluşturma
JSON formatı uyumluluğu, çeviri, indirim oluşturma
Güvenlik reddi (zararlı içerik), sayma, boole mantığı### Evaluation Strategies

Strateji	Açıklama	Örnek
'kesin'	Çıktı tam olarak eşleşmelidir	`"4"`
'içerir'	Çıktı alt dize içermelidir (büyük/küçük harfe duyarlı değil)	''Paris''
'normal ifade'	Çıktı normal ifade düzeniyle eşleşmelidir	`"1.2.3"`
'özel'	Özel JS işlevi doğru/yanlış değerini döndürür	`(çıkış) => çıktı.uzunluk > 10`	---

📖 Setup Guide

Protocol Setup (MCP + A2A)

🧩 MCP Kurulumu (Model Bağlam Protokolü)

MCP aktarımını stdio modunda başlatın:```bash omniroute --mcp


Önerilen doğrulama akışı:

1. MCP istemcinizi stdio üzerinden bağlayın.
2. 'omniroute_get_health'i çalıştırın.
3. 'omniroute_list_combos'u çalıştırın.
4. Kalp atışını, aktiviteyi ve denetimi onaylamak için `/dashboard/mcp`yi açın.

Otomasyon için faydalı API'ler:

- '/api/mcp/status'u AL'
- '/api/mcp/tools'U ALIN'
- '/api/mcp/audit'i AL'
- '/api/mcp/audit/stats'ı AL'</details>

<detaylar>
<summary><b>🤝 A2A Kurulumu (Agent2Agent)</b></summary>

Temsilciyi keşfedin:```bash
curl http://localhost:20128/.well-known/agent.json

Bir görev gönder:```bash curl -X POST http://localhost:20128/a2a
-H 'content-type: application/json'
-d '{"jsonrpc":"2.0","id":"setup-a2a","method":"message/send","params":{"skill":"quota-management","messages":[{"role":"user","content":"Summarize quota status."}]}}'


Yaşam döngüsünü yönetin:

- '/api/a2a/status'u AL'
- '/api/a2a/tasks'ı AL'
- `AL /api/a2a/tasks/:id'
- 'POST /api/a2a/tasks/:id/iptal'

Operasyonel kullanıcı arayüzü:

- Görev/durum/akış gözlemlenebilirliği ve duman eylemleri için `/dashboard/a2a`</details>

<detaylar>
<summary><b>🧪 Uçtan uca protokol doğrulama</b></summary>

Her iki protokolü de gerçek istemcilerle doğrulayın:```bash
npm run test:protocols:e2e

Bu şunları doğrular:

MCP SDK istemcisi bağlantısı/listesi/çağrısı
A2A keşfi/gönderme/akış/alma/iptal etme
MCP denetimi ve A2A görev yönetimi API'lerindeki verileri çapraz kontrol edin

💳 Abonelik Sağlayıcıları

### Claude Code (Pro/Max)

Dashboard → Providers → Connect Claude Code
→ OAuth login → Auto token refresh
→ 5-hour + weekly quota tracking

Models:
  cc/claude-opus-4-6
  cc/claude-sonnet-4-5-20250929
  cc/claude-haiku-4-5-20251001

**Profesyonel İpucu:**Karmaşık görevler için Opus'u, hız için Sonnet'i kullanın. OmniRoute model başına kotayı takip eder!### OpenAI Codex (Plus/Pro)

Dashboard → Providers → Connect Codex
→ OAuth login (port 1455)
→ 5-hour + weekly reset

Models:
  cx/gpt-5.2-codex
  cx/gpt-5.1-codex-max

Codex Account Limit Management (5h + Weekly)

Artık her Codex hesabının 'Kontrol Paneli -> Sağlayıcılar'da politika geçişleri var:

`5sa' (AÇIK/KAPALI): 5 saatlik pencere eşik politikasını uygulayın.
`Haftalık' (AÇIK/KAPALI): haftalık pencere eşik politikasını uygulayın.
Eşik davranışı: etkin bir pencere >=%90 kullanıma ulaştığında, o hesap atlanır.
Döndürme davranışı: OmniRoute bir sonraki uygun Codex hesabına otomatik olarak yönlendirir.
Sıfırlama davranışı: sağlayıcının 'resetAt' süresi geçtiğinde hesap otomatik olarak tekrar uygun hale gelir.

Senaryolar:

"5h ON" + "Weekly ON": pencerelerden herhangi biri eşiğe ulaştığında hesap atlanır.
"5 saat KAPALI" + "Haftalık AÇIK": yalnızca haftalık kullanım hesabı engelleyebilir.
"5 saat AÇIK" + "Haftalık KAPALI": yalnızca 5 saatlik kullanım hesabı bloke edebilir.
`resetAt' başarılı oldu: hesap otomatik olarak rotasyona yeniden giriyor (manuel yeniden etkinleştirme yok).### Gemini CLI (FREE 180K/month!)

Dashboard → Providers → Connect Gemini CLI
→ Google OAuth
→ 180K completions/month + 1K/day

Models:
  gc/gemini-3-flash-preview
  gc/gemini-2.5-pro

**En İyi Değer:**Devasa ücretsiz katman! Bunu ücretli katmanlardan önce kullanın.### GitHub Copilot

Dashboard → Providers → Connect GitHub
→ OAuth via GitHub
→ Monthly reset (1st of month)

Models:
  gh/gpt-5
  gh/claude-4.5-sonnet
  gh/gemini-3.1-pro-preview

🔑 API Anahtarı Sağlayıcıları

### NVIDIA NIM (FREE developer access — 70+ models)

Sign up: build.nvidia.com
Ücretsiz API anahtarını edinin (1000 çıkarım kredisi dahil)
Kontrol Paneli → Sağlayıcı Ekle → NVIDIA NIM:
- API Anahtarı: nvapi-anahtarınız

Modeller:"nvidia/llama-3.3-70b-instruct", "nvidia/mistral-7b-instruct" ve 50'den fazla model

**Profesyonel İpucu:**OpenAI uyumlu API — OmniRoute'un format çevirisiyle sorunsuz şekilde çalışır!### DeepSeek

Kaydolun: platform.deepseek.com
API anahtarını alın
Kontrol Paneli → Sağlayıcı Ekle → DeepSeek

Modeller:"deepseek/deepseek-sohbet", "deepseek/deepseek-kodlayıcı"### Groq (Free Tier Available!)

Kaydolun: console.groq.com
API anahtarını alın (ücretsiz katman dahil)
Kontrol Paneli → Sağlayıcı Ekle → Groq

Modeller:"groq/llama-3.3-70b", "groq/mixtral-8x7b"

**Profesyonel İpucu:**Ultra hızlı çıkarım — gerçek zamanlı kodlama için en iyisi!### OpenRouter (100+ Models)

Kaydolun: openrouter.ai
API anahtarını alın
Kontrol Paneli → Sağlayıcı Ekle → OpenRouter

**Modeller:**Tek bir API anahtarı aracılığıyla tüm büyük sağlayıcıların 100'den fazla modeline erişin.

Kontrol Paneli davranışı:OpenRouter modelleriKullanılabilir Modeller'den yönetilir. Manuel ekleme, içe aktarma ve otomatik senkronizasyonun tümü aynı listeyi günceller.

💰 Ucuz Sağlayıcılar (Yedekleme)

### GLM-4.7 (Daily reset, $0.6/1M)

Kaydolun: Zhipu AI
Kodlama Planından API anahtarını alın
Kontrol Paneli → API Anahtarı Ekle:
- Sağlayıcı: glm
- API Anahtarı: "anahtarınız"

Kullanım:glm/glm-4.7

**Profesyonel İpucu:**Kodlama Planı, 1/7 maliyetle 3 kat kota sunuyor! Her gün sabah 10:00'a sıfırlayın.### MiniMax M2.1 (5h reset, $0.20/1M)

Kaydolun: MiniMax
API anahtarını alın
Kontrol Paneli → API Anahtarı Ekle

Kullanım:minimax/MiniMax-M2.1

**Profesyonel İpucu:**Uzun bağlam için en ucuz seçenek (1 milyon token)!### Kimi K2 ($9/month flat)

Abone olun: Moonshot AI
API anahtarını alın
Kontrol Paneli → API Anahtarı Ekle

Kullanım:kimi/kimi-latest

**Profesyonel İpucu:**10 milyon token için ayda sabit 9 ABD doları = 0,90 ABD doları/1 milyon etkin maliyet!

🆓 ÜCRETSİZ Sağlayıcılar (Acil Durum Yedekleme)

### Qoder (5 FREE models via OAuth)

Dashboard → Connect Qoder
→ Qoder OAuth login
→ Unlimited usage

Models:
  if/kimi-k2-thinking
  if/qwen3-coder-plus
  if/glm-4.7
  if/minimax-m2
  if/deepseek-r1

Qwen (4 FREE models via Device Code)

Dashboard → Connect Qwen
→ Device code authorization
→ Unlimited usage

Models:
  qw/qwen3-coder-plus
  qw/qwen3-coder-flash

Kiro (Claude FREE)

Dashboard → Connect Kiro
→ AWS Builder ID or Google/GitHub
→ Unlimited usage

Models:
  kr/claude-sonnet-4.5
  kr/claude-haiku-4.5

🎨 Kombinasyonlar Oluşturun

### Example 1: Maximize Subscription → Cheap Backup

Dashboard → Combos → Create New

Name: premium-coding
Models:
  1. cc/claude-opus-4-6 (Subscription primary)
  2. glm/glm-4.7 (Cheap backup, $0.6/1M)
  3. minimax/MiniMax-M2.1 (Cheapest fallback, $0.20/1M)

Use in CLI: premium-coding

Example 2: Free-Only (Zero Cost)

Name: free-combo
Models:
  1. gc/gemini-3-flash-preview (180K free/month)
  2. if/kimi-k2-thinking (unlimited)
  3. qw/qwen3-coder-plus (unlimited)

Cost: $0 forever!

🔧 CLI Entegrasyonu

### Cursor IDE

Settings → Models → Advanced:
  OpenAI API Base URL: http://localhost:20128/v1
  OpenAI API Key: [from OmniRoute dashboard]
  Model: cc/claude-opus-4-6

Claude Code

Tek tıklamayla yapılandırma için kontrol panelindekiCLI Araçlarısayfasını kullanın veya ~/.claude/settings.json dosyasını manuel olarak düzenleyin.### Codex CLI

export OPENAI_BASE_URL="http://localhost:20128"
export OPENAI_API_KEY="your-omniroute-api-key"

codex "your prompt"

OpenClaw

Seçenek 1 — Kontrol Paneli (önerilen):``` Dashboard → CLI Tools → OpenClaw → Select Model → Apply


**Seçenek 2 — Manuel:**`~/.openclaw/openclaw.json`ı düzenleyin:```json
{
  "models": {
    "providers": {
      "omniroute": {
        "baseUrl": "http://127.0.0.1:20128/v1",
        "apiKey": "sk_omniroute",
        "api": "openai-completions"
      }
    }
  }
}

**Not:**OpenClaw yalnızca yerel OmniRoute ile çalışır. IPv6 çözümleme sorunlarını önlemek için "localhost" yerine "127.0.0.1" kullanın.### Cline / Continue / RooCode

Settings → API Configuration:
  Provider: OpenAI Compatible
  Base URL: http://localhost:20128/v1
  API Key: [from OmniRoute dashboard]
  Model: if/kimi-k2-thinking

OpenCode

**1. Adım:**OmniRoute'u özel sağlayıcı olarak ekleyin:```bash opencode /connect

Select "Other" → Enter ID: "omniroute" → Enter your OmniRoute API key


**2. Adım:**Proje kökünüzde `opencode.json` dosyasını oluşturun/düzenleyin:```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniroute": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniRoute",
      "options": {
        "baseURL": "http://localhost:20128/v1"
      },
      "models": {
        "cc/claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" },
        "gg/gemini-2.5-pro": { "name": "Gemini 2.5 Pro" },
        "if/kimi-k2-thinking": { "name": "Kimi K2 (Free)" }
      }
    }
  }
}

**3. Adım:**OpenCode'da modeli seçin:```bash /models

Select any OmniRoute model from the list


>**İpucu:**OmniRoute `/v1/models` uç noktanızda bulunan herhangi bir modeli `modeller` bölümüne ekleyin. OmniRoute kontrol panelinizden 'sağlayıcı/model kimliği' biçimini kullanın.</details>

---

## Sorun Giderme

<detaylar>
<summary><b>Sorun giderme kılavuzunu genişletmek için tıklayın</b></summary>

**"Dil modeli mesaj sağlamıyordu"**

- Sağlayıcı kotası tükendi → Kontrol paneli kotası izleyicisini kontrol edin
- Çözüm: Kombine geri dönüş kullanın veya daha ucuz seviyeye geçin

**Hız sınırlaması**

- Abonelik kotası doldu → GLM/MiniMax'a geri dönüş
- Kombinasyon ekleyin: `cc/claude-opus-4-6 → glm/glm-4.7 → if/kimi-k2-thinking`

**OAuth jetonunun süresi doldu**

- OmniRoute tarafından otomatik olarak yenilendi
- Sorunlar devam ederse: Kontrol Paneli → Sağlayıcı → Yeniden Bağlan

**Yüksek maliyetler**

- Kontrol Paneli → Maliyetler'deki kullanım istatistiklerini kontrol edin
- Birincil modeli GLM/MiniMax'a değiştirin
- Kritik olmayan görevler için ücretsiz katmanı (Gemini CLI, Qoder) kullanın

**Kontrol Paneli/API bağlantı noktaları yanlış**

- `PORT' standart temel bağlantı noktasıdır (ve varsayılan olarak API bağlantı noktasıdır)
- `API_PORT` yalnızca OpenAI uyumlu API dinleyicisini geçersiz kılar
- "DASHBOARD_PORT" yalnızca kontrol panelini/Next.js dinleyicisini geçersiz kılar
- `NEXT_PUBLIC_BASE_URL`yi kontrol panelinize/genel URL'nize ayarlayın (OAuth geri aramaları için)

**Bulut senkronizasyon hataları**

- `BASE_URL`nin çalışan örneğinize işaret ettiğini doğrulayın
- "CLOUD_URL"nin beklenen bulut uç noktanıza işaret ettiğini doğrulayın
- `NEXT_PUBLIC_*` değerlerini sunucu tarafı değerleriyle uyumlu tutun

**İlk giriş çalışmıyor**

- `.env`de `INITIAL_PASSWORD`u kontrol edin
- Ayarlanmadığında geri dönüş şifresi "123456" olur

**İstek günlüğü yok**

- İstek yapıları, istek başına bir JSON dosyası olarak "DATA_DIR/call_logs/" dizinine yazılır
- Aşama başına ayrıntılı yüklere ihtiyacınız varsa Kontrol Paneli → Günlükler → Günlükleri İste'den ardışık düzen yakalamayı etkinleştirin
- Uygulama konsolu günlüklerinin de "logs/application/app.log" içinde olmasını istiyorsanız "APP_LOG_TO_FILE=true" ayarını yapın
- `APP_LOG_MAX_FILE_SIZE`, `APP_LOG_RETENTION_DAYS`, `APP_LOG_MAX_FILES` ve `CALL_LOG_MAX_ENTRIES`'i gerektiği gibi ayarlayın

**Bağlantı testi OpenAI uyumlu sağlayıcılar için "Geçersiz" olduğunu gösteriyor**

- Birçok sağlayıcı `/models` uç noktasını göstermez
- OmniRoute v1.0.6+ includes fallback validation via chat completions
- Temel URL'nin `/v1' sonekini içerdiğinden emin olun### 🔐 OAuth on a Remote Server

<a name="oauth-on-a-remote-server"></a>
<a name="oauth-em-servidor-remoto"></a>

>**⚠️ OmniRoute'u VPS, Docker veya herhangi bir uzak sunucuda çalıştıran kullanıcılar için önemlidir**#### Why does Antigravity / Gemini CLI OAuth fail on remote servers?

**Antigravity**ve**Gemini CLI**sağlayıcıları**Google OAuth 2.0**kullanır. Google, OAuth akışındaki "redirect_uri"nin, uygulamanın Google Cloud Console'daki önceden kayıtlı URI'lerden biriyle tam olarak eşleşmesini gerektirir.

OmniRoute'ta bir araya getirilen OAuth kimlik bilgileri**yalnızca "localhost" için**kaydedilir. OmniRoute'a uzak bir sunucudan (ör. `https://omniroute.myserver.com`) eriştiğinizde Google, kimlik doğrulamayı şu şekilde reddeder:```
Error 400: redirect_uri_mismatch

Solution: Configure your own OAuth credentials

Google Cloud Console'da sunucunuzun URI'sıyla birOAuth 2.0 İstemci Kimliğioluşturmanız gerekir.#### Step-by-step

1. Google Cloud Console'u açın

Şuraya gidin: https://console.cloud.google.com/apis/credentials

2. Yeni bir OAuth 2.0 İstemci Kimliği oluşturun

-"+ Kimlik Bilgilerini Oluştur"→**"OAuth istemci kimliği"**seçeneğini tıklayın

Uygulama türü:"Web uygulaması"
Ad: beğendiğiniz herhangi bir şey (ör. 'OmniRoute Remote')

3. Yetkili Yönlendirme URI'lerini Ekle

**"Yetkili yönlendirme URI'leri"**alanına şunu ekleyin:``` https://your-server.com/callback


> `Sunucunuz.com`u sunucunuzun alan adı veya IP'si ile değiştirin (gerekirse bağlantı noktasını ekleyin, örneğin `http://45.33.32.156:20128/callback`).

**4. Kimlik bilgilerini kaydedin ve kopyalayın**

Oluşturduktan sonra Google,**Müşteri Kimliğini**ve**Müşteri Sırrını**gösterecektir.

**5. Ortam değişkenlerini ayarlama**

`.env`nizde (veya Docker ortam değişkenlerinde):```bash
# For Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

# For Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=your-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-your-secret

6. OmniRoute'u yeniden başlatın```bash

npm:

npm run dev

Docker:

docker restart omniroute


**7. Tekrar bağlanmayı deneyin**

Kontrol Paneli → Sağlayıcılar → Antigravity (veya Gemini CLI) → OAuth

Google artık doğru şekilde "https://sunucunuz.com/callback" adresine yönlendirecektir.---

#### Temporary workaround (without custom credentials)

Şu anda kendi kimlik bilgilerinizi ayarlamak istemiyorsanız**manuel URL akışını**kullanmaya devam edebilirsiniz:

1. OmniRoute, Google yetkilendirme URL'sini açar
2. Yetkilendirmeden sonra Google, "localhost"a yönlendirmeye çalışır (bu işlem uzak sunucuda başarısız olur)
3.**Tarayıcınızın adres çubuğundan tam URL'yi kopyalayın**(sayfa yüklenmese bile)
4. Bu URL'yi OmniRoute bağlantı modunda gösterilen alana yapıştırın
5.**"Bağlan"**'a tıklayın

> Bu, URL'deki yetkilendirme kodunun, yönlendirme sayfasının yüklenip yüklenmediğine bakılmaksızın geçerli olması nedeniyle işe yarar.---

<detaylar>
<summary><b>🇧🇷 Portekiz Versiyonu</b></summary>#### Por que o OAuth do Antigravity / Gemini CLI falha em servidores remotos?

Kimlik doğrulama için**Antigravity**ve**Gemini CLI**'nin**Google OAuth 2.0**kullandığı kanıtlanmıştır. Google, Google Cloud Console uygulaması için önceden hazırlanmış URI'ler nedeniyle**ekstra**OAuth akışı içermeyen bir "redirect_uri" kullanıyor.

OAuth kimlik doğrulaması, OmniRoute'un**localhost'ta**açılmasına izin vermez. Uzak bir sunucuda OmniRoute'a eriştiğinizde (ör. "https://omniroute.meuservidor.com") veya Google, com kimlik doğrulamasını reddetti:```
Error 400: redirect_uri_mismatch

Solução: Configure suas próprias credenciais OAuth

Sunucunuzun URI'sı ileOAuth 2.0 İstemci Kimliğiolmadan Google Cloud Console'u kesin olarak girin.#### Passo a passo

1. Google Cloud Console'a erişim

Abra: https://console.cloud.google.com/apis/credentials

2. Yeni bir OAuth 2.0 İstemci Kimliğiyle Ağlayın

-"+ Kimlik Bilgileri Oluştur"→**"OAuth istemci kimliği"**seçeneğini tıklayın

Uygulama türü:"Web uygulaması"
Ad: escolha qualquer adı (ör. OmniRoute Remote)

3. Yetkili Yönlendirme URI'leri Olarak Adicione

**"Yetkili yönlendirme URI'leri"**ek açıklaması yok:``` https://seu-servidor.com/callback


> Sunucunuzun IP'si veya IP'si için "seu-servidor.com" yerine (gerekli port dahil, örneğin: "http://45.33.32.156:20128/callback").

**4. Kimlik bilgileri olarak kaydedin ve kopyalayın**

Yazdıktan sonra Google,**Müşteri Kimliği**ve**Müşteri Sırrı**'nı arar.

**5. Ortam değişkenleri olarak yapılandırın**

".env" dosyası yok (veya Docker ortamının değişkenleri):```bash
# Para Antigravity:
ANTIGRAVITY_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
ANTIGRAVITY_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

# Para Gemini CLI:
GEMINI_OAUTH_CLIENT_ID=seu-client-id.apps.googleusercontent.com
GEMINI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret
GEMINI_CLI_OAUTH_CLIENT_SECRET=GOCSPX-seu-secret

6. OmniRoute'u Yeniden Başlat```bash

Se usando npm: