TokenLab

Văn bản

Đánh giá quyết định

Đánh giá các câu hỏi về xác suất, lựa chọn và điểm số được đặt tên bằng mô hình quyết định gốc.

POST
/v1/systemone

Gửi state và các questions được đặt tên tới một mô hình quyết định. Sử dụng GET /v1/models?category=decision để xem tính khả dụng hiện tại và GET /v1/models/{model} để xem hợp đồng đã xuất bản của mô hình đó.

Jev có hai phiên bản: phiên bản ổn định jev-1.14 (các bí danh yêu cầu jev-latest và jev-preview) và phiên bản cũ hơn jev-1.13. Các ví dụ sử dụng jev-1.13; hãy xem Decisions để lựa chọn giữa các phiên bản này.

state và instructions của mỗi câu hỏi chấp nhận một chuỗi, đối tượng JSON hoặc mảng JSON. Endpoint trả về JSON đồng bộ.

Loại câu hỏiTiêu chíKết quả
noulĐối tượng tùy chọn với hướng dẫn cho cả true và falsenoul, một xác suất từ 0 đến 1
choiceĐối tượng gồm 1–255 tên tùy chọn được ánh xạ tới hướng dẫn hoặc nullchoice, tùy chọn bao gồm probabilities và confidence
scoreMảng có thứ tự gồm 2–10 mô tảscore từ 0 đến chỉ mục cuối cùng; có thể là số thập phân, với tùy chọn legend, probabilities và confidence

Phản hồi bảo toàn tên câu hỏi của bạn trong mục answers. usage.input_tokens và usage.output_tokens báo cáo mức sử dụng quan sát được khi có sẵn. Giá cả được tính theo biểu phí hiện tại của mô hình; đầu ra miễn phí không có nghĩa là không có token đầu ra.

Tin nhắn trò chuyện, công cụ, streaming và Batch không thuộc phạm vi hợp đồng của endpoint này.

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"]
      }
    }
  }'

Yêu cầu HTTP cũng có thể được sử dụng với các client fetch hoặc requests tiêu chuẩn. Phản hồi quyết định là dữ liệu có cấu trúc, không phải là giải thích văn bản được tạo ra.

Ví dụ phản hồi. Các giá trị chỉ mang tính chất minh họa:

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

Lỗi

Yêu cầu sẽ từ chối các trường không xác định và các câu hỏi không hợp lệ với mã 400 invalid_request. Một mô hình không phải là mô hình quyết định sẽ trả về 400 unsupported_endpoint. Xử lý các trạng thái khác như trong phần Xử lý lỗi API.

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

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json