تقييم القرارات

أرسل state و questions المسماة إلى نموذج قرار. استخدم GET /v1/models?category=decision لمعرفة التوفر الحالي و GET /v1/models/{model} للاطلاع على العقد المنشور الخاص به.

يقبل state و instructions الخاصة بكل سؤال سلسلة نصية (string)، أو كائن JSON، أو مصفوفة JSON. تُرجع نقطة النهاية (endpoint) استجابة JSON متزامنة.

تحتفظ الاستجابة بأسماء أسئلتك تحت answers. تُبلغ usage.input_tokens و usage.output_tokens عن الاستخدام المرصود عند توفره. يتم تحديد التسعير بناءً على التعرفة الحالية للنموذج؛ المخرجات المجانية لا تعني عدم وجود رموز (tokens) للمخرجات.

رسائل الدردشة، والأدوات، والبث (streaming)، و Batch ليست جزءاً من عقد نقطة النهاية هذه.

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": {"billing": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

طلب HTTP قابل للاستخدام أيضاً مع عملاء fetch أو requests القياسيين. استجابة القرار هي بيانات مهيكلة، وليست شرحاً نصياً مولداً.

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  }}