API TypeSafe

Điểm cuối đánh giá HTTP

Nội dung yêu cầu có ba trường cấp cao nhất. state là bắt buộc và có thể là chuỗi, đối tượng hoặc mảng văn bản. model là bắt buộc; các ví dụ tài liệu dùng jev-latest. questions là bản đồ các đối tượng Question có kiểu. Bạn tự chọn từng khóa. Câu trả lời tương ứng được trả về dưới cùng ID. Khóa không được gửi tới mô hình nền và không tham gia suy luận.

Một Noul tối giản có dạng {"state": "Trợ giúp! Các khoản thanh toán của tôi đã bị lỗi suốt 3 ngày.", "model": "jev-latest", "questions": {"is_urgent": {"type": "noul", "instructions": "Nội dung này có thể hiện tính khẩn cấp không?"}}}. Choice thêm bản đồ tiêu chí từ tên tùy chọn đến mô tả. Score thêm mảng tiêu chí cấp độ có thứ tự. Cả ba đều có type và instructions; mỗi loại bổ sung cấu trúc criteria riêng.

Lấy khóa API từ https://console.typesafe.ai/settings/keys. Nếu gọi HTTP trực tiếp, hãy xử lý 429 bằng retry-after. Giới hạn của Jev 1.13 là 250,000 token mỗi giây và 1,200 yêu cầu mỗi phút; chúng có thể thay đổi mà không báo trước. Theo mặc định, SDK sẽ thử lại với thời gian chờ tăng dần. Dùng GET /v1/models cùng token Bearer để liệt kê mô hình.

SDK chính thức

Python: pip install typesafe-sdk. Nhập TypeSafeClient từ typesafe_sdk. Dùng TypeSafeClient() làm client: client.system_one(state, questions). Các hàm khởi tạo như Noul, Choice và Score đều có sẵn trong gói, nên bạn không phải tự viết trường kiểu JSON. Mô hình mặc định là jev-latest. Yêu cầu Python 3.10 trở lên.

JavaScript: npm install @typesafe-ai/sdk. Nhập { TypeSafeClient } từ "@typesafe-ai/sdk". Client kết nối đến cùng một endpoint. Môi trường chạy là Node.js 20+. Kho mã nguồn nằm tại https://github.com/typesafe-ai/typesafe-sdk-js. Cả hai SDK đều cung cấp models.list() để xem danh mục bí danh.

Sân thử nghiệm tại https://console.typesafe.ai/playground là bảng điều khiển yêu cầu đăng nhập, không phải nội dung nhúng công khai. Dán văn bản làm state, thêm một Noul như "Tin nhắn này có thể hiện tính khẩn cấp không?", rồi kết hợp thêm câu hỏi trong cùng một lần gọi. Đây là cách nhanh nhất để trải nghiệm đánh giá song song trước khi kết nối khóa dùng trong môi trường thực tế.

Lệnh curl đầu tiên

Dùng curl -X POST https://api.typesafe.ai/v1/systemone với Authorization: Bearer $TYPESAFE_API_KEY và Content-Type: application/json. Phần thân gồm: state là thông báo lỗi kết nối Stripe, model jev-latest, questions.urgency có type noul và instructions "Tin nhắn này có thể hiện tính khẩn cấp không?". Đó là mẫu khởi đầu nhanh. Thêm một Choice tên department với tiêu chí billing / technical / sales và một Score tên frustration với các cấp độ có thứ tự mà không cần thêm lượt trao đổi thứ hai.

Khi có lỗi, hãy đọc jaggedness trước khi bổ sung thêm diễn giải vào chỉ dẫn. Tác vụ đọc theo nghĩa đen cần nêu chính xác điều kiện trong chỉ dẫn và tiêu chí. Phép toán nên được xử lý bằng mã. Tác vụ sinh nội dung cần một mô hình khác. API vẫn trả về payload có kiểu nếu bạn yêu cầu Jev viết một đoạn văn qua các Choice nối tiếp; cách này sẽ chậm và cho kết quả kém. Hãy dùng regex hoặc mô hình sinh để đề xuất phương án, rồi để Jev chọn.

Cloudflare Workers AI liệt kê typesafe/jev làm tên trong danh mục. Đây là mục niêm yết của bên thứ ba, không thay thế api.typesafe.ai. Steam không có ứng dụng Jev. Hãy giữ khóa trên bảng điều khiển của TypeSafe và xem các SDK cộng đồng trên Awesome Jev là không chính thức, trừ khi chúng theo sát tổ chức github.com/typesafe-ai.

Lỗi, thử lại và ID

429 Too Many Requests là phản hồi được ghi trong tài liệu khi bạn vượt quá số token mỗi giây hoặc yêu cầu mỗi phút. Hãy tuân thủ retry-after. SDK chính thức đã tự tăng thời gian chờ. Nếu tự bọc HTTP, đừng liên tục gọi điểm cuối khi gặp 429; bạn vẫn sẽ nằm trong cùng khung giới hạn.

ID câu hỏi dùng cho dấu vết của bạn và không bao giờ tham gia suy luận. Bạn có thể tạo item_0 đến item_n trong vòng lặp mà vẫn nhận một Noul cho mỗi mục. Mỗi khóa phải là duy nhất trong một yêu cầu. Dùng lại khóa sẽ âm thầm ghi đè câu hỏi trong bản đồ.

Thông tin xác thực là khóa API Bearer TypeSafe từ bảng quản lý. api.typesafe.ai không dùng phiên cookie. Hãy xoay vòng khóa trong bảng điều khiển, không phải bằng cách gửi email cho wiki này. Tường đăng nhập của sân thử nghiệm là phần riêng: đó là bảng điều khiển trên trình duyệt, không phải API HTTP thay thế.

Sao chép lệnh curl khởi đầu nhanh một lần, rồi xóa nó khỏi kho mã và chuyển sang SDK. SDK đảm nhiệm thử lại và các hàm khởi tạo có kiểu. HTTP thô dành cho ngôn ngữ chưa có máy khách chính thức. Dù theo cách nào, khóa Bearer và cùng phần thân JSON vẫn được gửi tới POST /v1/systemone.

GET /v1/models liệt kê các bí danh mà tài khoản của bạn có thể gửi. Danh sách có thể không chứa jev-1.13.0 dù ID đó vẫn hoạt động với POST /v1/systemone. Đừng coi danh sách này là danh sách cho phép đối với ID có phiên bản. Hãy coi đó là danh mục bí danh và giữ ID có phiên bản trong cấu hình riêng.

Tuyệt đối không commit TYPESAFE_API_KEY. Nếu bị lộ, hãy xoay vòng khóa trong bảng quản lý. contact@jevai.wiki không phải nơi báo khóa bí mật bị lộ — hãy dùng các kênh riêng của TypeSafe.

Python 3.10 và Node.js 20 là phiên bản tối thiểu theo tài liệu. Môi trường chạy cũ hơn không được máy khách chính thức hỗ trợ.