OnyRouter: Soruya Göre Otomatik AI Model Seçimi (onysoft/auto API Rehberi)

Katalogda 708+ model varken her istek için "hangisini kullanmalıyım?" sorusu gerçek bir mühendislik yükü: hızlı işlere amiral model bağlarsanız fatura şişer, derin analizi ekonomik modele verirseniz kalite düşer. OnyRouter bu kararı sizden alır — gelen mesajı analiz eder, soru tipini sınıflandırır ve isteği o iş için en uygun modele yönlendirir. Kullanımı tek satır: model alanına onysoft/auto yazın. Yönlendirmenin kendisi tamamen ücretsizdir; yalnızca seçilen gerçek modelin kullanımı faturalandırılır. Bu teknoloji dünyada az sayıda platformda bulunuyor ve Türkiye'nin yerli AI gateway'inde ilk kez Onysoft'ta: hem panel içi Chat'te hem de doğrudan API'de, kendi uygulamalarınızda kullanabileceğiniz şekilde açık.

OnyRouter Nedir, Nasıl Çalışır?

OnyRouter iki katmanlı bir yönlendirme motorudur. Birinci katman sezgiseldir ve sıfır gecikme ekler: mesajda kod izleri (kod blokları, hata çıktıları, teknik komutlar) varsa istek doğrudan kod kategorisine, çok kısa bir selamlaşmaysa hızlı kategorisine gider. İkinci katman bir sınıflandırıcıdır: sezgilerin net karar veremediği mesajlar, hafif ve hızlı bir modele "bu soru hangi türde?" diye sorulur ve tek kelimelik yanıt alınır. Sınıflandırma sistemin kendi altyapısında çalışır — size ne token maliyeti ne de ek ücret yansır.

Belirlenen kategori bir rota tablosuyla gerçek modele çevrilir: hızlı sorular hız sınıfının en iyi modeline, kod ve genel sohbet dengeli bir amiral modele, derin analiz muhakeme gücü en yüksek modele, hacimli mekanik işler en ekonomik modele, görsel içeren istekler ise görüntü anlayan bir modele gider. Rota tablosunu model katalogundaki gelişmelere göre sürekli güncelleriz — yeni bir model sınıfının en iyisi olduğunda rotayı biz değiştiririz, sizin kodunuz onysoft/auto demeye devam eder. Seçilen model her yanıtta şeffaftır: API yanıtındaki model alanı yönlendirilen gerçek modeli gösterir.

Neden Otomatik Model Seçimi?

Üretim sistemlerinde en yaygın iki hata kalıbı vardır: her işi tek amiral modele yüklemek (trafiğin %80'i basit işken amiral fiyatı ödersiniz) ve her işi tek ekonomik modele yüklemek (kritik sorularda kalite kaybını kullanıcılarınız fark eder). Doğru mimari katmanlı model seçimidir; ama bunu elle kurmak, istek tiplerini sınıflandıran kod yazmak ve model kataloğunu sürekli takip etmek demektir.

OnyRouter bu katmanı hazır verir. Benzer yaklaşımlar dünyada da yeni yeni yaygınlaşıyor — örneğin OpenRouter'ın auto rotası ve akademik tarafta RouteLLM gibi yönlendirme çalışmaları — ancak Türkiye'de TL faturalama, yerel destek ve KVKK uyumuyla birlikte sunan yerli bir gateway'de ilk kez Onysoft'ta bulacaksınız. Üstelik iki yüzeyde birden: panel içi Chat'te "⚡ OnyRouter" varsayılan seçenektir; API'de ise onysoft/auto sanal modeli, kendi ürününüze aynı zekâyı tek satırla katmanızı sağlar. Kendi SaaS'ınızı, chatbot'unuzu veya iç aracınızı geliştiriyorsanız model seçim mantığını hiç yazmadan geçebilirsiniz.

API'de Kullanım: Python, curl ve Streaming

OnyRouter'ı kullanmak için özel bir uç nokta yok — bildiğiniz /v1/chat/completions, model adı onysoft/auto:

from openai import OpenAI

client = OpenAI(
    base_url="https://api.onysoft.com/v1",
    api_key="sk-ony-ANAHTARINIZ",
)

response = client.chat.completions.create(
    model="onysoft/auto",
    messages=[{"role": "user", "content": "Bu Python fonksiyonundaki hatayı bul ve düzelt: ..."}],
)
print(response.model)   # yönlendirilen gerçek model (örn. anthropic/claude-sonnet-5)
print(response.choices[0].message.content)

Aynı istek curl ile:

curl https://api.onysoft.com/v1/chat/completions \
  -H "Authorization: Bearer sk-ony-ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "onysoft/auto",
    "messages": [{"role": "user", "content": "Merhaba!"}]
  }'

Streaming de aynı şekilde çalışır — stream=True deyin, yanıt seçilen modelden gerçek zamanlı akar; akış içindeki chunk'ların model alanından hangi modelin yanıtladığını görebilirsiniz. onysoft/auto ayrıca /v1/models listesinde sanal bir model olarak görünür, yani model kataloğunu programatik tarayan uygulamalarınız da onu keşfeder.

Kategoriler: Hangi Soru Nereye Gider?

OnyRouter altı kategoriyle çalışır. Güncel rota mantığı şöyle özetlenebilir:

• Hızlı — kısa/basit sorular, selamlaşmalar, tek cümlelik bilgi istekleri → hız sınıfının önde gelen modeli (bugün Gemini Flash sınıfı).
• Genel — normal sohbet, yazım, özet, çeviri → dengeli amiral model (bugün Claude Sonnet sınıfı).
• Kod — programlama, hata ayıklama, teknik komutlar → kodda en güçlü dengeli model.
• Derin — çok adımlı analiz, strateji, matematik/mantık, uzun doküman değerlendirmesi → muhakeme amirali (bugün GPT-5.6 sınıfı).
• Ekonomik — toplu sınıflandırma/etiketleme gibi hacimli mekanik işler → en iyi fiyat/performans modeli (bugün DeepSeek sınıfı).
• Görsel — görüntü/fotoğraf analizi istekleri → görüntü anlayan güçlü model.

Parantez içindeki örnekler yazım tarihindeki rotalardır; katalog geliştikçe rotaları güncelleriz. Sabit bir modele kilitlenmek istediğiniz uçlar için her zaman modelin tam adını (anthropic/claude-sonnet-5 gibi) kullanmaya devam edebilirsiniz — onysoft/auto bir seçenektir, zorunluluk değil.

Faturalama, Şeffaflık ve Sınırlar

Faturalama modeli bilinçli olarak basit tutuldu: yönlendirme ücretsizdir, istek seçilen gerçek modelin katalog fiyatıyla faturalandırılır. Kullanım kayıtlarınızda ve panel raporlarınızda istek, yönlendirilen modelin adıyla görünür; sürpriz bir "router ücreti" kalemi yoktur. Maliyet planlaması için maliyet hesaplayıcıda kategori başına beklediğiniz hacmi ilgili rotanın modeliyle hesaplayabilirsiniz.

Bilinmesi gereken iki sınır: (1) Model kilidi (allowed_models) tanımlı özel anahtarlarda, OnyRouter'ın seçtiği model kilit listesinde değilse istek 403 ile reddedilir — kilitli anahtarlar zaten belirli modellere adanmıştır, bu anahtarlarda auto yerine doğrudan model adı kullanın. (2) Sınıflandırıcı katmanı ilk token gecikmesine tipik olarak birkaç saniye ekleyebilir; kod ve selamlaşma gibi net durumlarda sezgi katmanı devreye girdiği için bu gecikme çoğu zaman hiç yaşanmaz. Gecikmeye en duyarlı uçlarınızda sabit model adıyla devam edip kalan trafiği onysoft/auto'ya bırakmak iyi bir orta yoldur.

Başlamak için: ücretsiz kayıt olun, panelden sk-ony- anahtarınızı üretin ve ilk isteğinizde model alanına onysoft/auto yazın. Kod yazmadan denemek isterseniz panel Chat'te ⚡ OnyRouter zaten varsayılan seçilidir.