Metin
Kararları Değerlendir
Adlandırılmış olasılık, seçim ve puan sorularını yerel bir karar modeliyle değerlendirin.
state ve adlandırılmış questions öğelerini bir karar modeline gönderin. Mevcut kullanılabilirlik için GET /v1/models?category=decision ve yayınlanmış sözleşmesi için GET /v1/models/{model} uç noktalarını kullanın.
Jev'in iki sürümü bulunmaktadır: kararlı jev-1.14 (istek takma adları jev-latest ve jev-preview) ve daha önceki jev-1.13. Örneklerde jev-1.13 kullanılmaktadır; bunlar arasında seçim yapmak için Kararlar bölümüne bakın.
state ve her sorunun instructions alanı bir string, JSON nesnesi veya JSON dizisi kabul eder. Uç nokta, senkronize JSON döndürür.
| Soru tipi | Kriterler | Sonuç |
|---|---|---|
noul | Hem true hem de false rehberliği içeren isteğe bağlı nesne | noul, 0 ile 1 arasında bir olasılık |
choice | Rehberliğe eşlenmiş 1–255 seçenek adı içeren nesne veya null | choice, isteğe bağlı olarak probabilities ve confidence |
score | 2–10 açıklama içeren sıralı dizi | 0'dan son indekse kadar score; kesirli olabilir, isteğe bağlı legend, probabilities ve confidence içerir |
Yanıt, soru adlarınızı answers altında korur. usage.input_tokens ve usage.output_tokens, mevcut olduğunda gözlemlenen kullanımı raporlar. Fiyatlandırma, modelin mevcut tarifesinden gelir; ücretsiz çıktı, sıfır çıktı token'ı anlamına gelmez.
Sohbet mesajları, araçlar, akış (streaming) ve Batch bu uç noktanın sözleşmesinin bir parçası değildir.
curl https://api.tokenlab.sh/v1/systemone \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev-1.13",
"state": "I was charged twice. Please refund the duplicate payment.",
"questions": {
"refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
"department": {
"type": "choice", "instructions": "Which team should handle this?",
"criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
},
"urgency": {
"type": "score", "instructions": "Rate urgency",
"criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
}
}
}'HTTP isteği, standart fetch veya requests istemcileriyle de kullanılabilir. Bir karar yanıtı, oluşturulmuş bir metin açıklaması değil, yapılandırılmış veridir.
Örnek yanıt. Değerler gösterim amaçlıdır:
{
"model": "jev-1.13",
"answers": {
"refund_requested": { "type": "noul", "noul": 0.97 },
"department": {
"type": "choice",
"choice": "refunds",
"probabilities": { "refunds": 0.93, "technical": 0.07 },
"confidence": 0.93
},
"urgency": { "type": "score", "score": 1.2, "confidence": 0.7 }
},
"usage": { "input_tokens": 412, "output_tokens": 38 }
}Hatalar
İstek, bilinmeyen alanları ve geçersiz soruları 400 invalid_request ile reddeder. Karar modeli olmayan bir model 400 unsupported_endpoint döndürür. Diğer durumları API hatalarını yönetme bölümünde açıklandığı gibi ele alın.
curl -X POST "https://example.com/v1/systemone" \ -H "Content-Type: application/json" \ -d '{ "model": "string", "state": "string", "questions": { "property1": { "type": "noul", "instructions": "string" }, "property2": { "type": "noul", "instructions": "string" } } }'{ "id": "string", "model": "string", "answers": { "property1": { "type": "noul", "noul": 0 }, "property2": { "type": "noul", "noul": 0 } }, "usage": { "input_tokens": 0, "output_tokens": 0 }}Yetkilendirme
BearerAuth API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
İstek gövdesi
application/json
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json
application/json