Entegrasyon rehberleri · 2026-10-10
Perplexity Decider API: /v1/systemone ile olasılıklı kararlar, 1M token 0,02 $
Perplexity Decider'ı perplexity/pplx-decider-v1.1-27b kimliğiyle LLMTR'nin /v1/systemone ucundan çağırın: evet/hayır, seçim ve puan; 1M girdi token'ı 0,02 $.
Kısa cevap: metin değil olasılık döndüren bir karar modeli
LLMTR (llmtr.com), Türkiye'de ve global sağlayıcılarda barındırılan dil modellerine tek, OpenAI uyumlu API'den erişim veren bir gateway'dir. Perplexity Decider'ı burada perplexity/pplx-decider-v1.1-27b model kimliğiyle, https://llmtr.com/v1/systemone uç noktası üzerinden çağırırsınız; temel adres diğer modellerde olduğu gibi https://llmtr.com/v1'dir. Fiyat 1 milyon girdi token'ı başına 0,02 $ olarak uygulanır; çıktının fiyatı yoktur ve istek başına ayrı ücret alınmaz.
Decider bir sohbet modeli değildir. Ona bir durum (state) ve kendi tanımladığınız soruları (questions) gönderirsiniz; her soru için yapılandırılmış bir yanıt döner: evet/hayır sorusunda evet olasılığı, seçim sorusunda seçeneklerinizden biri, puan sorusunda kendi ölçeğinizde bir konum. Ayrıştırılacak serbest metin yoktur ve her yanıtla olasılıklar gelir; neyin otomatik uygulanacağını eşikle siz belirlersiniz.
Perplexity Decider API'si nasıl çağrılır?
İsteği https://llmtr.com/v1/systemone adresine POST ile, Authorization: Bearer başlığında LLMTR API anahtarınızla gönderin. Gövdede üç alan vardır: model, state ve questions. state düz metin, JSON nesnesi ya da dizi olabilir; questions ise anahtarlarını sizin seçtiğiniz bir soru eşlemesidir. Aşağıdaki istek bir müşteri mesajına aynı anda üç soru sorar.
Soru anahtarları modele gönderilmez, yalnızca yanıtı eşleştirmeye yarar; sorunun tamamını instructions alanına yazın. Aynı istekteki sorular birbirinden bağımsız değerlendirilir, bir yanıt diğerine bağlam olmaz. Gövde katı doğrulanır: yanlış yazılmış bir alan 400 invalid_request alır ve mesaj hatalı alanı söyler. Perplexity'nin kendi API'si için yazılmış bir istemciyi taşıyorsanız adresi ve model alanını LLMTR'dekiyle değiştirin; LLMTR'de her soru bir instructions alanı taşımalıdır.
Bir destek mesajına noul, choice ve score tipinde üç soru soran curl isteği.
curl https://llmtr.com/v1/systemone \
-H "Authorization: Bearer $LLMTR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "perplexity/pplx-decider-v1.1-27b",
"state": "Order 4417 arrived with a cracked screen. I want my money back, this is the second time.",
"questions": {
"refund_requested": {
"type": "noul",
"instructions": "Does the customer ask for a refund?"
},
"team": {
"type": "choice",
"instructions": "Which team should handle this message?",
"criteria": {
"billing": "Payments, invoices, refunds",
"technical": "Bugs, outages, integrations",
"other": null
}
},
"frustration": {
"type": "score",
"instructions": "How frustrated does the customer appear?",
"criteria": ["Calm", "Frustrated but civil", "Very angry"]
}
}
}'Üç soru tipi: noul, choice ve score
noul evet/hayır sorusudur ve cevabın evet olma olasılığını 0 ile 1 arasında verir; criteria isteğe bağlıdır ve yalnızca true ile false uçlarını açıklar. choice, criteria içinde tanımladığınız seçeneklerden birini seçer ve bütün seçeneklerin olasılık dağılımını döndürür. Girdi listeye sığmayabilecekse other gibi bir seçenek ekleyin; yoksa model her zaman en yakın seçeneği döndürür.
score sıralı seviyeler boyunca bir konum verir. Perplexity'nin belgesine göre bu değer seviye sıralarının olasılık ağırlıklı ortalamasıdır ve iki seviyenin arasına düşebilir. Evet/hayır ile seviyeyi karıştırmayın: noul'da 0,5 orta seviye demek değildir, modelin iki cevaba eşit olasılık verdiği anlamına gelir.
| Tip | criteria | Yanıt alanları | Sınır |
|---|---|---|---|
| noul | isteğe bağlı: true ve false açıklaması | noul (evet olasılığı, 0-1) | yok |
| choice | seçenek adı ve açıklaması ya da null | choice, probabilities, confidence | 1-255 seçenek |
| score | sıralı seviye listesi | score, legend, probabilities, confidence | 2-10 seviye |
Yanıt nasıl okunur, eşik nereye konur?
Yanıt, istekte verdiğiniz anahtarlarla answers altında döner ve her yanıt kendi type alanını taşır. model alanı LLMTR katalog kimliğini, usage girdi ve çıktı token sayılarını verir. score yanıtında legend her sırayı seviye adınıza eşler. Aşağıdaki yanıt yukarıdaki isteğin biçimini gösterir; değerler örnektir.
confidence yalnızca choice ve score yanıtlarında bulunur ve dağılımın tek bir seçenekte ne kadar toplandığını özetler. Yalnızca en olası seçeneği kullanacaksanız choice alanını okumak yeterlidir. Eşik, kararı otomatik uygulamakla bir insana devretmek arasında ayrım yaptığınız yerde işe yarar. Eşikleri ve soru metinlerini kodda tek bir dosyada tutun.
Örnek yanıt: alanlar Decider'ın döndürdüğü biçimdedir, sayılar örnektir.
{
"model": "perplexity/pplx-decider-v1.1-27b",
"answers": {
"refund_requested": { "type": "noul", "noul": 0.97 },
"team": {
"type": "choice",
"choice": "billing",
"confidence": 0.9,
"probabilities": { "billing": 0.93, "technical": 0.05, "other": 0.02 }
},
"frustration": {
"type": "score",
"score": 1.62,
"confidence": 0.62,
"legend": { "0": "Calm", "1": "Frustrated but civil", "2": "Very angry" },
"probabilities": { "0": 0.02, "1": 0.34, "2": 0.64 }
}
},
"usage": { "input_tokens": 389, "output_tokens": 3 }
}Fiyat: girdi token'ı başına ücret, durum her soruda yeniden sayılır
perplexity/pplx-decider-v1.1-27b için 1 milyon girdi token'ı 0,02 $'dır ve çıktının fiyatı yoktur. usage içindeki output_tokens yine de sıfırdan büyük gelebilir; ücretsiz olan çıktının sayısı değil fiyatıdır. Bu modelin fiyatına marj eklenmez; LLMTR'nin %8 platform payı yalnızca kredi yüklerken alınır.
Durum her soru için yeniden sayılır. 2.000 token'lık bir duruma beş soru sorduğunuzda soru metinleri hariç yaklaşık 10.000 girdi token'ı faturalanır, bu da yaklaşık 0,0002 $ eder; yalnızca sonucunu kullanacağınız soruları gönderin. İsteğe bağlı max_budget_usd alanı, gövdeden hesaplanan tahmini maliyet bu değeri aşarsa isteği reddeder. Kesin bir üst sınır için API anahtarı başına harcama limitini kullanın.
Sınırlar, hata kodları ve v1 sürümü
Bir istekte en fazla 128 soru gönderilir; fazlası 400 provider_error döner. Her soru durumla birlikte 262.144 token'ın altında kalmalıdır; aşan istek yaklaşık bir dakika sonra 502 ile döner. Yanıt süresi girdiyle uzadığı için istemci zaman aşımını en az 90 saniye yapın. Akış yoktur, yanıt tek parça gelir; anahtarın hız sınırı aşılınca 429 döner.
perplexity/pplx-decider-v1-27b aynı modelin ilk sürümüdür; fiyatı, bağlamı ve istek biçimi aynıdır. Ona sabitlenmiş bir entegrasyon kimliği değiştirmeden çalışmaya devam eder, yeni bir entegrasyon ise perplexity/pplx-decider-v1.1-27b ile başlar. Decider modelleri Playground'da ve sohbet uç noktalarında yoktur; yalnızca /v1/systemone üzerinde yanıt verir.
Perplexity Decider'ı LLMTR üzerinden çağırma
Hesap açın, API anahtarı oluşturun ve perplexity/pplx-decider-v1.1-27b ile https://llmtr.com/v1/systemone adresine ilk karar isteğini gönderin.
- Hesap. llmtr.com'da bir hesap oluşturun ve kredi yükleyin. Ücret ön ödemeli krediden katalog fiyatıyla düşülür.
- API anahtarı. Dashboard > API Anahtarları altında bir anahtar oluşturun. Ham anahtar yalnızca bir kez gösterilir; LLMTR_API_KEY ortam değişkeninde saklayın. Aynı anahtar katalogdaki her modelde çalışır.
- İlk karar. model, state ve questions alanlarını taşıyan bir JSON gövdesini https://llmtr.com/v1/systemone adresine gönderin ve answers altındaki olasılıkları okuyun.
Sık sorulan sorular
Perplexity Decider API'si ne kadar?
LLMTR'de perplexity/pplx-decider-v1.1-27b için 1 milyon girdi token'ı 0,02 $'dır; çıktının fiyatı yoktur ve istek başına ücret alınmaz. Durum her soru için yeniden sayıldığından toplam token sayısı soru sayısıyla artar.
Perplexity Decider metin üretir mi?
Hayır. Her soru için yapılandırılmış bir yanıt döndürür: noul'da evet olasılığı, choice'ta seçilen seçenek ve olasılıklar, score'da kendi ölçeğinizde bir konum. Akış desteği yoktur.
Perplexity Decider OpenAI SDK ile çağrılabilir mi?
Chat Completions istemcisiyle çağrılamaz; Decider yalnızca https://llmtr.com/v1/systemone uç noktasında yanıt verir. Herhangi bir HTTP istemcisiyle model, state ve questions taşıyan JSON gövdesini Authorization: Bearer başlığıyla göndermeniz yeterlidir.