Modeller

Desteklenen AI modelleri

Onysoft AI Gateway, dünya çapındaki önde gelen AI sağlayıcılarının modellerini tek bir API üzerinden sunar. Metin modelleri OpenAI uyumlu /v1/chat/completions ucundan, görsel, video, ses ve müzik modelleri asenkron üretim uçlarından kullanılır.

Mevcut Modeller

Tüm modelleri ve güncel fiyatları görüntüleyin →

Ücretsiz Türkiye Modelleri (:tr)

Model kimliği ":tr" ile biten modeller Türkiye'de barındırılır ve ücretsizdir: bu isteklerde bakiyenizden hiçbir tutar düşülmez. Aynı API anahtarı, aynı uçlar ve aynı istek gövdesiyle çalışırlar; tek fark model kimliğidir.

Sınırlar

• Hesap başına (tüm API anahtarlarınız birlikte) son 24 saatte en fazla 100 istek gönderilebilir; hesabınız için özel bir limit tanımlandıysa o geçerlidir. Ücretsiz modeller yalnız doğrulanmış hesaplara açıktır: Google veya GitHub ile giriş yapılmış ya da gerçek ödemeyle (kart/havale) en az bir kez bakiye yüklenmiş olmalıdır.
• Sohbet isteklerinde istek başına en fazla yaklaşık 64.000 girdi tokenı ve 20 MB gövde gönderilebilir; modelin bağlam penceresi daha büyük olsa da bu sınır geçerlidir. Sınırı aşan istekler açıklayıcı bir hata ile reddedilir.
• Aynı anda en fazla 4 istek işlenir (kişisel anahtarlarda hesap başına, proje ve iş ortağı anahtarlarında anahtar başına; hesabınıza özel bir değer tanımlandıysa o geçerlidir). Fazla istekler kısa bir süre sırada bekler; yer açılmazsa 429 (tr_yogun ya da tr_concurrency_limit) ve Retry-After döner. Bu ret günlük hakkınızdan düşülmez.
• Ücretsiz oldukları için kullanım kaydınızda görünürler ancak tutar 0 TL olarak işlenir.
• Görsel girdi kabul eden modeller: deepseek/deepseek-v4.1-flash:tr, qwen/qwen3.8-flash-next:tr, google/gemma-4-31b:tr, qwen/qwen3-vl-30b:tr, xiaomi/mimo-v2.6-pro:tr. Diğer modellere görsel gönderilirse istek, günlük hakkınızdan düşülmeden açıklayıcı bir hata ile reddedilir.
• Bazı modeller yanıtlamadan önce düşünür: düşünme metni yanıttaki reasoning alanında döner ve yanıtla aynı max_tokens bütçesini paylaşır. Düşünen modellerde (DeepSeek, Qwen, Gemma, GLM ve MiMo) max_tokens değerini en az 2048, tercihen 4096 verin; çok küçük max_tokens değerinde (ör. 24) bütçenin tamamı düşünmeye gidebilir: bu durumda content null döner ve finish_reason "length" olur. Düşünmeyi kapatıp yanıtı hızlandırmak için deepseek/deepseek-v4-flash:tr, deepseek/deepseek-v4.1-flash:tr, qwen/qwen3.8-flash-next:tr, xiaomi/mimo-v2.6-pro:tr modellerinde "reasoning_effort": "none" gönderin. google/gemma-4-31b:tr modelinde ise "chat_template_kwargs": {"enable_thinking": false} kullanın. google/gemma-4-31b:tr, qwen/qwen3-vl-30b:tr modellerinde reasoning_effort alanı desteklenmez; gönderilirse yok sayılır. xiaomi/mimo-v2.6-pro:tr modelinde reasoning_effort yalnız şu değerleri alır: none, minimal, low, medium, high, xhigh; başka bir değer günlük hakkınızdan düşülmeden reddedilir.
• Konuşmadan metne modelinde response_format yalnız json veya text olabilir; yaklaşık 30 saniyelik kayıtlar ve en fazla 10 MB dosya gönderilebilir.

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

Bu modeller ücretsiz oldukları için kapasiteye bağlı olarak zaman zaman yoğun olabilir. Kesintisiz çalışması gereken üretim işleri için katalogdaki ücretli modelleri tercih edin.

Tencent Cloud üzerinden ücretsiz modeller (16 Kasım 2026 tarihine kadar)

Aşağıdaki modellerin Tencent Cloud üzerinden sunulan sürümlerini 16 Kasım 2026, 23:59 (TSİ) tarihine kadar ücretsiz kullanabilirsiniz. Yeni bir anahtar gerekmez: mevcut API anahtarınızla model adının sonuna :tencent eklemeniz yeterli. Bu istekler bakiyenizden düşülmez.

Sınırlar

• Hesap başına kayan 24 saatte en çok 100 istek; ayrıca hesap başına günlük kullanım bütçesi uygulanır. Sınır dolduğunda 429 döner ve yeni hakkın açılacağı saat yanıtta yazılır.
• İstek başına en çok ~64.000 girdi ve 16.384 çıktı token’ı (max_tokens daha yüksekse 16.384’e indirilir); istek gövdesi en çok 20 MB.
• Hesap başına aynı anda en çok 2 istek.
• Yalnız metin girdisi ve araç çağrısı (function calling) desteklenir; görsel, ses ve dosya girdisi kabul edilmez.
• Ücretsiz modellerin uygunluk koşulları (doğrulanmış hesap) bu sürümlerde de geçerlidir. Toplam kampanya kapasitesi sınırlıdır; dolarsa ücretsiz kullanım günün geri kalanında ya da dönem sonuna kadar durabilir (429).
• İstekler Tencent Cloud’un Singapur bölgesinde işlenir. deepseek/deepseek-v4.1-flash:tencent sürümünde istek, Tencent Cloud üzerinden model geliştiricisi DeepSeek’in altyapısına iletilir.
• :tr modelleri Türkiye’de Onysoft sunucusunda çalışır; :tencent sürümleri Tencent Cloud’da çalışır.
• 16 Kasım 2026 tarihinden sonra :tencent sürümleri kapanır ve 404 free_period_ended döner. Ücretli modelleri (örneğin tencent/hy4) kullanmaya devam edebilirsiniz.

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

Hata kodları

• 429 free_model_rate_limit, free_model_concurrency, free_quota_exhausted: sınır doldu; Retry-After başlığına bakın.
• 503 model_unavailable: model geçici olarak kullanılamıyor; biraz sonra yeniden deneyin.
• 413 payload_too_large: istek, ücretsiz sürümün girdi sınırını aşıyor.
• 400 invalid_request: bu ücretsiz sürümün desteklemediği bir istek biçimi (ör. görsel girdi).
• 404 free_period_ended: ücretsiz dönem sona erdi.

Tipli Karar Ucu (/v1/decisions)

Bu uç metin üretmez. Sorduğunuz ikili soruya 0 ile 1 arasında kalibre bir olasılık döner — "bu müşteri insan desteği mi istiyor?", "bu mesaj engelleyici bir arıza mı bildiriyor?" gibi. Sohbet modeline JSON şema dayatıp cevabı ayrıştırmaya göre hem daha hızlı hem daha ucuzdur; ayrıştırma hatası diye bir şey yoktur, çünkü dönen şey zaten sayıdır.

Ayrıntılı kullanım, soru tipleri ve hata kodları için Tipli Karar API bölümüne bakın.