Văn bản
Xếp hạng lại tài liệu
Xếp hạng lại các tài liệu theo mức độ liên quan với một truy vấn
Xếp hạng lại các tài liệu bằng cách sử dụng các mô hình tương đồng ngữ nghĩa. Hữu ích cho việc cải thiện kết quả tìm kiếm và các ứng dụng RAG.
Nội dung yêu cầu
Với đầu vào lớn, đặt thời gian chờ của máy khách HTTP ít nhất 120s. Phản hồi trả về sau khi xử lý hoàn tất.
ID của mô hình reranker cần sử dụng (ví dụ: qwen3-vl-rerank).
Truy vấn để xếp hạng các tài liệu dựa trên đó. Độ dài tối đa: 32,000 ký tự.
Danh sách các tài liệu (chuỗi) cần xếp hạng lại. Giới hạn: tối đa 1,000 tài liệu, mỗi tài liệu tối đa 100,000 ký tự, và tổng số ký tự tài liệu tối đa 2,000,000.
Số kết quả hàng đầu, từ 1 đến documents.length. Nếu bỏ qua, mô hình được chọn quyết định số lượng.
falseCó bao gồm văn bản tài liệu gốc trong phản hồi hay không.
Phản hồi
Danh sách các tài liệu đã được xếp hạng kèm theo điểm số.
Mỗi kết quả bao gồm:
index(integer): Chỉ mục tài liệu gốcrelevance_score(number): Điểm liên quan. Phạm vi phụ thuộc vào mô hình được chọn.document(string): Văn bản gốc (nếureturn_documents=true)
Mô hình được sử dụng để xếp hạng lại. Trả về khi có sẵn.
Thống kê mức sử dụng token. Trả về khi có sẵn.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/rerank" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3-vl-rerank",
"query": "What is machine learning?",
"documents": [
"Machine learning is a subset of AI",
"The weather is nice today",
"Deep learning uses neural networks"
],
"top_n": 2,
"return_documents": true
}'Phản hồi
{
"results": [
{
"index": 0,
"relevance_score": 0.95,
"document": "Machine learning is a subset of AI"
},
{
"index": 2,
"relevance_score": 0.82,
"document": "Deep learning uses neural networks"
}
],
"model": "qwen3-vl-rerank",
"usage": {
"prompt_tokens": 45,
"total_tokens": 45
}
}Xác thực
BearerAuth 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
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