eu/jev: API phân loại văn bản đặt tại Đức

eu/jev là API ra quyết định độc lập do Bevelites GmbH vận hành. Dịch vụ giúp nhà phát triển phân loại nội dung, chuyển yêu cầu hỗ trợ và đánh giá các lựa chọn theo tiêu chí được mô tả.

eu/jev dùng để làm gì? Giải thích dễ hiểu

Giả sử khách hàng báo hóa đơn có khoản thu sai. Bạn mô tả hai nhãn «thanh toán» và «hỗ trợ kỹ thuật», rồi eu/jev trả về lựa chọn cùng thông tin xác suất. Ứng dụng có thể đọc các trường này để quyết định bước tiếp theo. Playground minh họa cách tương tác; việc nối với hệ thống hỗ trợ và thực hiện hành động vẫn do bạn tích hợp.

Phân biệt phân loại AI với thể loại văn bản

Đây là việc dự đoán nhãn cho nội dung, không chỉ phân biệt thể loại văn học hay loại văn bản hành chính. Mô tả rõ ý nghĩa từng nhãn và chuẩn bị ví dụ thông thường, mơ hồ và ít gặp với đáp án đã kiểm tra. Quy trình công khai dùng mô hình có sẵn, không yêu cầu tự huấn luyện mô hình trước, nhưng cần kiểm chứng sự phù hợp.

Đặt nhãn và gửi yêu cầu API đầu tiên

Cần tài khoản đã được chấp thuận và khóa từ bảng điều khiển. Đơn truy cập được xét theo năng lực phục vụ; gửi biểu mẫu không tạo tài khoản hay bảo đảm được nhận. Giữ khóa trên máy chủ.

Đặt ngữ cảnh vào state, câu hỏi có tên vào questions, và mô tả 2–10 lựa chọn trong criteria của choice. Gửi JSON bằng POST đến https://eu-jev.com/v1/systemone với Bearer và Content-Type: application/json. Dùng jeff-latest hoặc bản cố định được tài liệu hỗ trợ như jeff-1.0.0. Kiểm tra trạng thái HTTP rồi đọc answers.team.choice, probabilities và confidence. State cũng có thể là đối tượng hoặc mảng JSON.

Ví dụ dựa trên định dạng công khai, chưa gọi bằng khóa thật. Danh sách ngôn ngữ đầy đủ chưa được công bố: thử tiếng Việt và nội dung của dự án trước.

Tài liệu chính thức còn có ví dụ HTTP bằng JavaScript và Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Hóa đơn có khoản thu bổ sung. Tôi cần kiểm tra.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Chọn nhóm phù hợp để xử lý tin nhắn này.",
      "criteria": {
        "billing": "Hóa đơn, thanh toán và hoàn tiền",
        "technical": "Lỗi, gián đoạn và truy cập tài khoản"
      }
    }
  }
}'

Định dạng API và lỗi

Đọc lựa chọn, xác suất và điểm số

Choice trả về lựa chọn, xác suất và confidence. Độ tin cậy được chuẩn hóa so với đoán đều, khác với xác suất của nhãn được chọn. Noul trả xác suất có/không từ 0 đến 1. Score dùng 2–10 tiêu chí có thứ tự và trả vị trí kỳ vọng từ 0 đến N−1, kèm xác suất và chú giải; không phải thang phần trăm cố định.

So sánh dự đoán với đáp án đã kiểm tra trước khi đặt ngưỡng tự động. Phản hồi còn có phiên bản mô hình, token đầu vào, ID yêu cầu và chi phí chính xác meta.cost_eur khi thành công.

Tín dụng ban đầu và chi phí token

Kiểm tra ngày 5 tháng 10 năm 2026, bằng EUR: tài khoản mới được nhận có €5 tín dụng khuyến mại một lần, không đặt lại hàng tháng hay thu tiền tự động. Giá là €37 mỗi tỷ token đầu vào, tương đương €0.037 mỗi triệu; đầu ra miễn phí.

Ngữ cảnh, hướng dẫn, tiêu chí và token chuẩn bị được tính; state dùng chung tính một lần. Đầu vào lặp lại hoặc có trong bộ nhớ đệm vẫn cùng đơn giá. Chỉ kết quả thành công dùng số dư, kể cả Playground đã đăng nhập. Thiếu tín dụng gây HTTP 402 insufficient_credits trước suy luận. Nhu cầu thêm được gửi qua biểu mẫu; việc trả phí cần thỏa thuận rõ ràng riêng.

Giá và điều khoản dịch vụ

Suy luận tại Đức và dữ liệu tài khoản

Origin, cơ sở dữ liệu ứng dụng và tiến trình mô hình ở Hetzner, Đức; đường suy luận được mô tả không có proxy mô hình ngoài hoặc CDN. Đầu vào và câu trả lời không lưu bền trong cơ sở dữ liệu/log ứng dụng và không dùng huấn luyện, nhưng bộ nhớ đệm RAM có thể còn giữa các yêu cầu.

Thông tin tài khoản, sử dụng, tín dụng và bảo mật được lưu, không có tác vụ tự xóa theo tuổi bản ghi tài khoản/sử dụng. Google, email và biểu mẫu ngoài có thể xử lý ngoài EEA, gồm Mỹ. Suy luận ở Đức không nghĩa mọi dữ liệu chỉ trong EU. Xử lý dữ liệu cá nhân cho doanh nghiệp cần DPA; trong Playground ẩn danh dùng nội dung tổng hợp hoặc không chứa dữ liệu cá nhân.

Xử lý nhạy cảm hoặc rủi ro cao cần điều kiện bằng văn bản và biện pháp bảo vệ riêng; quyết định quan trọng cần sự kiểm tra phù hợp của con người.

Quyền riêng tư và xử lý · DPA cho doanh nghiệp

Giới hạn và phạm vi tương thích

Khóa và Playground đăng nhập dùng chung 60 yêu cầu/phút mỗi tài khoản. Ẩn danh cho phép 12/phút và 100/ngày mỗi khách. API giới hạn 256 KiB JSON, state chuỗi 100.000 ký tự, tám câu hỏi, 1.000 ký tự hướng dẫn và 500 mỗi tiêu chí sau chuyển thành chuỗi. Đầu vào chuẩn bị phải vừa 32.768 vị trí ngữ cảnh, gồm nhánh và định dạng. Trường Playground riêng giới hạn 12.000 ký tự.

Yêu cầu chạy từng lượt, ưu tiên khóa, chờ hàng đợi đến 20 giây. Tôn trọng Retry-After ở 429/503 và sửa đầu vào khi 422. latency_ms không phải độ trễ toàn hành trình mạng. Tương thích TypeSafe chỉ là cấu trúc HTTP; ID mô hình Jev trả 400, không bảo đảm SDK hay kết quả giống nhau. Tích hợp thương mại theo điều khoản; mô hình Winnow không làm dịch vụ này thành mã nguồn mở hoặc tự triển khai được.

Câu hỏi khi tích hợp

eu/jev phân loại văn bản để làm gì?

Gán nhãn hoặc đánh giá có cấu trúc cho ngữ cảnh, chẳng hạn phân luồng tin nhắn hỗ trợ. Ứng dụng triển khai hành động tiếp theo.

Có cần tự huấn luyện mô hình trước khi dùng API không?

Quy trình được tài liệu mô tả dùng mô hình lưu trữ sẵn và nhãn trong yêu cầu, không cần huấn luyện riêng trước. Vẫn phải thử kết quả.

Làm sao kiểm tra kết quả phân loại trước khi tự động xử lý?

So sánh văn bản đại diện với đáp án được xác nhận, kiểm tra trường hợp khó và dành bước xem lại của con người cho kết quả quan trọng. Xác suất không bảo đảm đúng.

Tín dụng ban đầu có được cấp lại mỗi tháng không?

Không. €5 chỉ cấp một lần cho tài khoản được nhận. Yêu cầu thành công dùng số dư theo giá token đầu vào; dùng thêm và trả phí cần thỏa thuận rõ ràng riêng.

Suy luận tại Đức có nghĩa mọi dữ liệu tài khoản ở trong EU không?

Không. Google, email và biểu mẫu có thể xử lý ngoài EEA. Dữ liệu cá nhân cho doanh nghiệp cần DPA; nơi suy luận không đại diện cho mọi luồng dữ liệu.

Tài liệu và đăng ký chính thức

• FAQ chính thức và mô hình
• Đăng ký truy cập hoặc sử dụng thêm