Metin

Kararları Değerlendir

Adlandırılmış olasılık, seçim ve puan sorularını yerel bir karar modeliyle değerlendirin.

POST
/v1/systemone

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 tipiKriterlerSonuç
noulHem true hem de false rehberliği içeren isteğe bağlı nesnenoul, 0 ile 1 arasında bir olasılık
choiceRehberliğe eşlenmiş 1–255 seçenek adı içeren nesne veya nullchoice, isteğe bağlı olarak probabilities ve confidence
score2–10 açıklama içeren sıralı dizi0'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
AuthorizationBearer <token>

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

X-TokenLab-Delivery-Policy?string

İ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