Tipli Karar Ucu

Metin değil, kalibre olasılık döndüren modeller

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.

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.

• convai/laya-multilingual yalnız ikili karar (noul) sorularını yanıtlar ve Türkiye sunucumuzda çalışır. typesafe/jev üç soru tipini de destekler (noul, choice, score) ve her cevapla birlikte güven değeri döner.
• Şu an yalnız ikili karar soruları desteklenir ("type": "noul"). Tek istekte 32 soruya kadar sorabilirsiniz.
• Model Türkiye sunucumuzda çalışır; istek üçüncü bir sağlayıcıya gitmez.
• Yalnız girdi tokeni faturalanır, çıktı ücretsizdir.
• Seçenek (choice) ve puan (score) sorularına ihtiyacınız varsa kendi sağlayıcı anahtarınızı panelden bağlayıp aynı uçtan kullanabilirsiniz.

curl https://api.onysoft.com/v1/decisions \
  -H "Authorization: Bearer sk-ony-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "convai/laya-multilingual",
    "state": "Botla degil gercek bir yetkiliyle gorusmek istiyorum.",
    "questions": {
      "insan_istiyor": {
        "type": "noul",
        "instructions": "Does the user ask to talk to a human agent instead of the bot?"
      }
    }
  }'

{
  "success": true,
  "data": {
    "model": "convai/laya-multilingual",
    "answers": {
      "insan_istiyor": { "type": "noul", "noul": 0.9626, "confidence": 0.9626 }
    },
    "usage": { "input_tokens": 65, "output_tokens": 0 },
    "billing": "onysoft",
    "latency_ms": 52
  }
}

Soru Tipleri

convai/laya-multilingual şu an yalnız noul sorularını yanıtlar; diğer tipler 400 unsupported_question_type döner. typesafe/jev üç tipi de destekler.

Kendi Sağlayıcı Anahtarınızla Kullanım

Katalogdaki modellere ek olarak, tipli karar sağlayıcısındaki kendi hesabınızı da bağlayabilirsiniz. Bu durumda istek sizin anahtarınızla iletilir ve doğrudan sağlayıcıdaki hesabınızdan faturalanır.

GET    /v1/provider-keys            # kayitli anahtarlar (anahtarin kendisi DONMEZ)
POST   /v1/provider-keys            # {"provider":"typed-decisions","api_key":"...","label":"..."}
DELETE /v1/provider-keys/{provider} # anahtari kaldir

curl https://api.onysoft.com/v1/provider-keys \
  -H "Authorization: Bearer sk-ony-..." \
  -H "Content-Type: application/json" \
  -d '{"provider": "typed-decisions", "api_key": "SAGLAYICI-ANAHTARINIZ"}'

• Kendi anahtarınızla yapılan isteklerde Onysoft bakiyenizden kesinti yapılmaz; kullanım kaydınızda tutar 0 olarak görünür.
• Anahtarlar şifreli saklanır ve hiçbir uçta geri döndürülmez; yalnızca son dört karakterden oluşan bir ipucu gösterilir.
• Anahtarları panelden de ekleyip kaldırabilirsiniz.

Hata Kodları

Sınırlar ve Faturalama

• Tek istekte en fazla 32 soru sorulabilir; hepsi tek geçişte yanıtlanır.
• Yalnızca girdi tokeni faturalanır, çıktı ücretsizdir. Tutar kullanım kaydınıza normal şekilde işlenir.
• Bağlam sınırı modele göre değişir: katalog sayfasında her modelin bağlam penceresi yazılıdır.