Jina Rerank

Xếp hạng lại tài liệu ứng viên bằng cấu trúc yêu cầu Rerank theo định dạng Jina AI.

API Jina Rerank xếp hạng tài liệu ứng viên theo mức độ liên quan đến văn bản truy vấn và trả về tài liệu gốc, chỉ số, điểm liên quan cùng thống kê sử dụng Token. Yêu cầu và phản hồi sử dụng cấu trúc trường theo định dạng Jina AI.

POST/v1/rerank

Tính điểm liên quan của tài liệu ứng viên với văn bản truy vấn và trả về kết quả theo thứ tự mức độ liên quan. AGTCloud trả về kết quả theo định dạng Jina AI; một số API tương thích cũng chuyển đổi sang cấu trúc này.

Truy vấn và tài liệu có thể sử dụng nhiều ngôn ngữ. Để kết quả ổn định hơn, nên dùng truy vấn rõ ràng, cụ thể, giữ nội dung tài liệu đầy đủ và tránh để mỗi tài liệu vượt quá giới hạn Token của mô hình được chọn. Nên xử lý nhiều tài liệu theo từng lô; có thể lưu kết quả vào bộ nhớ đệm của ứng dụng cho các truy vấn ổn định, lặp lại.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Tham số yêu cầu xếp hạng lại tài liệu.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model?string

ID mô hình xếp hạng lại cần sử dụng, ví dụ jina-reranker-v2-base-multilingual. Hãy sử dụng mô hình khả dụng với tài khoản hiện tại.

query*string

Văn bản truy vấn dùng để xếp hạng tài liệu ứng viên theo mức độ liên quan. Nên dùng truy vấn rõ ràng, cụ thể; cách diễn đạt tương đồng về ngôn ngữ giữa truy vấn và tài liệu thường giúp kết quả ổn định hơn.

top_n?integer

Trả về N tài liệu liên quan nhất. Nếu không cung cấp, số lượng kết quả không bị giới hạn; đặt giá trị phù hợp giúp giảm truyền tải và xử lý kết quả không cần thiết.

documents*array<string>

Danh sách tài liệu cần xếp hạng lại. Mỗi tài liệu nên đầy đủ, có ý nghĩa rõ ràng và không vượt quá giới hạn Token của mô hình được chọn. Nên xử lý nhiều tài liệu theo từng lô; danh sách có thể chứa văn bản đa ngôn ngữ.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/rerank" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "query": "Sản phẩm chăm sóc da hữu cơ cho da nhạy cảm",    "top_n": 3,    "documents": [      "Chăm sóc da hữu cơ cho da nhạy cảm với nha đam và hoa cúc...",      "Xu hướng trang điểm mới tập trung vào màu sắc nổi bật và kỹ thuật sáng tạo...",      "Bio-Hautpflege für empfindliche Haut mit Aloe Vera und Kamille..."    ]  }'

{
  "results": [
    {
      "document": {
        "text": "Chăm sóc da hữu cơ cho da nhạy cảm với nha đam và hoa cúc..."
      },
      "index": 0,
      "relevance_score": 0.8783142566680908
    },
    {
      "document": {
        "text": "Bio-Hautpflege für empfindliche Haut mit Aloe Vera und Kamille..."
      },
      "index": 2,
      "relevance_score": 0.762467586994171
    }
  ],
  "usage": {
    "prompt_tokens": 815,
    "completion_tokens": 0,
    "total_tokens": 815
  }
}

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`