Qwen: Qwen3 Rerank

Qwen3 Rerank sắp thứ tự văn bản ứng viên theo truy vấn và chỉ dẫn được cung cấp. Hồ sơ mang mã qwen3-rerank nhận danh sách tài liệu văn bản và trả về điểm độ liên quan kèm chỉ mục cùng siêu dữ liệu sử dụng cho quy trình truy xuất và chọn tài liệu.

Ailoot Ultra · Xếp hạng lại POST /v1/rerank qwen3-rerank

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Qwen3 Rerank đánh giá văn bản ứng viên theo truy vấn và chỉ dẫn xếp hạng được cung cấp. Bộ chọn được cấu hình chính xác là qwen3-rerank. Vai trò của mô hình là sắp thứ tự các ứng viên được cung cấp cho công việc truy xuất và chọn tài liệu; yêu cầu giữ truy vấn, chỉ dẫn và các đoạn ứng viên cùng nhau để có thể truy ngược đánh giá độ liên quan về đầu vào.

Chuẩn bị documents dưới dạng mảng chuỗi, mỗi phần tử chứa một đoạn ứng viên. Giữ ánh xạ riêng từ từng vị trí trong mảng đến mã định danh tài liệu, tiêu đề hoặc vị trí nguồn của bạn. Nhờ vậy, ứng dụng có thể nối lại kết quả được xếp hạng với đoạn gốc mà không thêm các đối tượng mã định danh chưa được tài liệu hóa vào mảng chuỗi. Với tìm kiếm hỗ trợ, các ứng viên có thể là những phần liên quan đã truy xuất từ hướng dẫn sản phẩm; truy vấn cần nêu nhu cầu thông tin thực tế của người dùng.

Yêu cầu được tài liệu hóa bắt buộc có model, documents, query, top_n và instruct. Các trường query và instruct là chuỗi, còn top_n là số nguyên được cung cấp rõ ràng. Ví dụ công bố sử dụng ba văn bản ứng viên, top_n=2 và chỉ dẫn truy xuất các đoạn liên quan trả lời truy vấn tìm kiếm web. Dùng instruct để nêu quan hệ quan trọng đối với xếp hạng, đồng thời giữ câu hỏi thực tế trong query và tài liệu cần đánh giá trong documents.

Hướng dẫn thao tác liệt kê độ dài đầu vào tối đa là 30K. Giữ các đoạn ứng viên tập trung vào phần văn bản cần để đánh giá độ liên quan, đồng thời giữ tiêu đề hoặc ngữ cảnh lân cận khi chúng làm thay đổi ý nghĩa. Giữ ranh giới nguồn để vẫn có thể kiểm tra đoạn được chọn trong tài liệu gốc. Hồ sơ yêu cầu chính xác và các trường bắt buộc của nó vẫn là cơ sở để chuẩn bị đầu vào.

Kết quả có cấu trúc được trả về chứa các mục results với index và relevance_score. index trỏ đến vị trí ứng viên trong mảng documents gốc, thay vì vị trí của nó trong danh sách kết quả đã xếp hạng. Giữ thứ tự được trả về và dùng từng index để lấy lại văn bản đầu vào tương ứng. Giữ mọi kết quả trả về để ứng dụng có thể xem các ứng viên được chọn cùng điểm của chúng.

Giữ toàn bộ phản hồi JSON, bao gồm model, id phản hồi và usage.total_tokens. Văn bản tài liệu trả về có thể không có, nên hãy giữ mảng ứng viên gốc sẵn dùng khi xử lý chỉ mục. Điểm độ liên quan và mức sử dụng được báo cáo có vai trò riêng: điểm mô tả kết quả xếp hạng, còn usage ghi lại lượng được báo cáo cho thao tác. Không thành phần nào thay thế đoạn nguồn làm cơ sở cho câu trả lời sau đó.

Với quy trình truy xuất, dùng xếp hạng để chọn các đoạn mà bước tiếp theo nên kiểm tra hoặc trích dẫn. So sánh đoạn được chọn với truy vấn và chỉ dẫn trước khi trình bày nội dung của nó như bằng chứng. Vị trí cao trong danh sách kết quả xác định một ứng viên cần rà soát; câu trả lời cuối cùng của ứng dụng vẫn cần gắn với văn bản thực tế và mã định danh nguồn.

Rà soát kết quả bằng các truy vấn tiêu biểu và tập ứng viên mà ứng dụng sử dụng. Kiểm tra rằng chỉ mục dẫn đến đúng văn bản gốc dự kiến, thứ tự phục vụ chỉ dẫn đã cung cấp và các đoạn được chọn giải đáp câu hỏi. Giữ bộ chọn chính xác, truy vấn, chỉ dẫn, ánh xạ ứng viên và phản hồi đầy đủ cùng nhau, tạo bản ghi lựa chọn theo độ liên quan có thể tái sử dụng cho bước truy xuất hoặc xử lý tài liệu tiếp theo.

Ailoot Ultra · Xếp hạng lại POST /v1/rerank qwen3-rerank

qwen3-rerank

Qwen /qwen3-rerank

Bắt đầu

Đầu vào được chấp nhận: Văn bản
Kết quả: structured

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Xếp hạng lại POST /v1/rerank

Đầu vào: text
Đầu ra: structured
Định dạng đầu ra: application/json

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn qwen3-rerank Điều kiện: Giá trị bộ chọn mô hình nguyên dạng.	Mặc định—
Trường`documents`	Loại`array`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện: Các đoạn văn bản ứng viên, được giữ theo thứ tự đầu vào ban đầu.	Mặc định—
Trường`query`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện: Truy vấn mức độ liên quan.	Mặc định—
Trường`top_n`	Loại`integer`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện: Số kết quả xếp hạng yêu cầu; không khẳng định mức tối thiểu, tối đa hoặc mặc định chưa được tài liệu quy định.	Mặc định—
Trường`instruct`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Điều kiện: Chỉ dẫn mô tả tác vụ truy xuất.	Mặc định—

Tổ hợp tư liệu đầu vào

Tham số phương thức và vòng đời

Tham số	Hợp đồng
Tham số`content_type`	Hợp đồngapplication/json
Tham số`required`	Hợp đồngmodel, documents, query, top_n, instruct
Tham số`optional`	Hợp đồng
Tham số`material_types`	Hợp đồngtext
Tham số`additional_properties`	Hợp đồngtrue

Vòng đời: synchronous

Bảng giá

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Mức phí Ailoot

Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

Cấu hình	Biểu mức phí	Đơn vị tính phí	Phí
Cấu hìnhGiá cơ sở cho token	Biểu mức phíMức phí cơ bản	Đơn vị tính phí—	Phí Đầu vào · Token đầu vào — / 1K token Đầu ra · Token đầu ra — / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token
Cấu hìnhTổng số token	Biểu mức phí—	Đơn vị tính phí/ 1K token	Phí Đầu vào · Tổng số token $0.00014 / 1K token

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →

Ví dụ yêu cầu

Ailoot Ultra · Xếp hạng lại

JSON · xếp hạng lại văn bản

{
  "model": "qwen3-rerank",
  "query": "Which passage discusses text ranking?",
  "documents": [
    "Text ranking orders candidate passages by relevance.",
    "Quantum computing studies computation using quantum systems.",
    "Pretrained language models can improve text ranking."
  ],
  "top_n": 2,
  "instruct": "Given a web search query, retrieve relevant passages that answer the query."
}

Nhận và lưu kết quả

Ailoot Ultra · Xếp hạng lại

Đọc các chỉ số và điểm liên quan, rồi ánh xạ từng chỉ số về tài liệu gốc của bạn. Tài liệu được gửi lại có thể không có trong phản hồi.

Nếu cần kiểm tra phản hồi gốc

Giữ nguyên phản hồi và id yêu cầu ban đầu sau lần gửi không rõ kết quả; tuyệt đối không gửi lại.

Trường phản hồi

Trường	Loại	Ý nghĩa
Trường`results[].index`	Loạiinteger	Ý nghĩaChỉ số của tài liệu đầu vào gốc tương ứng.
Trường`results[].relevance_score`	Loạinumber	Ý nghĩaĐiểm liên quan được trả về.
Trường`model`	Loạistring	Ý nghĩaMô hình thực tế trong phản hồi.
Trường`id`	Loạistring	Ý nghĩaMã định danh phản hồi thực tế.
Trường`usage.total_tokens`	Loạiinteger	Ý nghĩaTổng số token đo được dùng để tính tiền.

Lỗi và bước tiếp theo

Phản hồi	Điều kiện	Bước tiếp theo
Phản hồi400 · `invalid_request_error`	Điều kiệnJSON hoặc lựa chọn mô hình bắt buộc không hợp lệ.	Bước tiếp theoSửa đầu vào được chỉ ra trước khi gửi yêu cầu mới.
Phản hồi401 · `authentication_error`	Điều kiệnKhóa API không hợp lệ.	Bước tiếp theoDùng khóa API Ailoot hợp lệ của bạn.
Phản hồi503 · `price_unavailable`	Điều kiệnChưa có cấu trúc giá hoặc quyền sử dụng cho phương thức.	Bước tiếp theoGiữ nguyên phản hồi ban đầu; không gửi lại lần gửi không rõ kết quả.

Bí danh

Bí danh mô hình

Ailoot Ultra qwen3-rerank

Bí danh đường dẫn phương thức

Dùng các đường dẫn phương thức hiển thị ở trên.

ID gọi liên quan

qwen3-rerank

FAQ · Qwen: Qwen3 Rerank

Có những đầu vào và kết quả nào?: POST /v1/rerank · qwen3-rerank: text → structured
Yêu cầu sử dụng những trường nào?: POST /v1/rerank · qwen3-rerank: model, documents, query, top_n, instruct

Qwen: Qwen3 Rerank