Source: https://ailoot.ai/models/vi/voyageai-rerank-2-5/
Canonical: https://ailoot.ai/models/vi/voyageai-rerank-2-5/
Language: vi

# VoyageAI by MongoDB: rerank-2.5

[Markdown](https://ailoot.ai/models/vi/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/vi/voyageai-rerank-2-5/facts.json)

## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/vi/voyageai-rerank-2-5/)

rerank-2.5 sắp lại tập ứng viên văn bản cung cấp theo độ liên quan với truy vấn và chỉ dẫn ngôn ngữ tự nhiên tùy chọn. Đây là bộ xếp hạng lại đa ngôn ngữ hướng chất lượng, có ngữ cảnh truy vấn–tài liệu 32,000 token và điểm xếp hạng gắn chỉ số ứng viên gốc.

- [**Ailoot Ultra · Xếp hạng lại** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/vi/voyageai-rerank-2-5/#method-0)

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.

rerank-2.5 là bộ xếp hạng lại tuân thủ chỉ dẫn của Voyage AI, thiết kế để tinh chỉnh tập ứng viên tìm kiếm. Mô hình xem đồng thời truy vấn và từng tài liệu như cross-encoder, rồi trả thứ tự liên quan. Bản phát hành nhấn mạnh điều khiển bằng ngôn ngữ tự nhiên về thế nào là liên quan, truy xuất đa ngôn ngữ và ngữ cảnh truy vấn–tài liệu dài hơn rerank-2 trước.

#### Cung cấp ứng viên để mô hình so sánh

Đầu vào là truy vấn và danh sách tài liệu văn bản ứng viên. Chúng có thể là đoạn chọn bởi tìm embedding hoặc tìm từ vựng giai đoạn đầu. Bộ xếp hạng lại đánh giá văn bản cung cấp, không tạo embedding cho tập tài liệu, nên nhiệm vụ thực tiễn là tinh chỉnh ứng viên tìm kiếm ban đầu đã tìm thấy.

Giữ thứ tự ứng viên ban đầu và mã định danh nguồn khi chuẩn bị danh sách. Chỉ số trả về chỉ vị trí đầu vào đó. Với RAG, cung cấp đoạn bước trả lời thực sự có thể dùng, gồm tiêu đề hoặc điều kiện cần để hiểu. Tài liệu liên quan vắng khỏi tập ứng viên gửi không thể xuất hiện như kết quả mới tìm được qua xếp lại.

#### Nêu khái niệm độ liên quan dự kiến

Chỉ dẫn có thể thêm sau hoặc trước truy vấn. Bản phát hành mô tả ba vai trò hữu ích: nhấn phần tài liệu, ưu tiên loại nguồn và làm rõ truy vấn bằng bối cảnh ứng dụng. Chúng đổi tác vụ liên quan được giao cho mô hình.

Với tìm kỹ thuật, chỉ dẫn minh họa là “Ưu tiên đoạn giải thích hành vi khi lỗi và khôi phục; tổng quan nhập môn là thứ yếu.” Với bộ nghiên cứu, nêu tiêu đề, phương pháp hay kết quả quan trọng nhất. Với từ mơ hồ, nêu lĩnh vực tìm kiếm. Giữ câu hỏi và chỉ dẫn tương thích để một bên không hỏi chủ đề rộng trong khi bên kia âm thầm đổi tác vụ.

Các ưu tiên hướng dẫn chấm độ liên quan. Nếu ứng dụng có yêu cầu đủ tư cách chặt — như phiên bản nguồn, ngày hoặc phạm vi truy cập — chuẩn bị tập ứng viên hợp lệ riêng. Chỉ dẫn liên quan của mô hình và hạn chế tập tài liệu xác định bằng quy tắc phục vụ mục đích khác nhau.

#### Đầu ra xếp hạng và sử dụng kết quả sau

Kết quả sắp độ liên quan giảm dần, có điểm liên quan số thực dấu phẩy động và chỉ số đầu vào gốc của ứng viên. Tùy chọn top-k chọn số kết quả đầu trả; thiếu nó, đặc tả nhà sản xuất trả mọi ứng viên gửi. Cài đặt return-documents tùy chọn kèm văn bản nguồn tương ứng; nếu không, phản hồi chứa chỉ số, điểm.

Dùng thứ tự để chọn đoạn hiển thị hoặc cho bước trả lời sau, giữ danh tính nguồn nguyên. Xem văn bản thực khi đánh giá thứ hạng: điểm đo độ liên quan với truy vấn gửi, không phải câu trả lời tạo ra hay xác minh khẳng định tài liệu đúng. Điều này hữu ích để tinh chỉnh tài liệu tìm kiếm kỹ thuật, pháp lý, tài chính, y tế, hội thoại và đa ngôn ngữ mà không biến xếp hạng thành kết luận chuyên môn.

#### Ngữ cảnh, tổng ngân sách token và cắt ngắn

Giới hạn truy vấn được tài liệu hóa là 8,000 token, gồm chỉ dẫn trong truy vấn. Truy vấn cộng một tài liệu ứng viên bất kỳ phải vừa 32,000 token, danh sách tối đa 1,000 mục. Tổng cho phép 600,000 token, tính bằng token truy vấn nhân số tài liệu cộng mọi token tài liệu. Vì vậy chỉ dẫn dài được tính lặp qua các cặp ứng viên.

Số top-k đầu ra không đổi số ứng viên trong phép tính token đầu vào đó. Cắt ngắn mặc định rút truy vấn hoặc tài liệu quá dài cho vừa giới hạn; tắt thì truy vấn hoặc cặp quá dài trả lỗi. Chuẩn bị chủ đích đoạn chứa câu trả lời, giữ điều kiện liên quan trong văn bản mô hình thấy. Đánh giá thứ tự tinh chỉnh trên câu hỏi, chỉ dẫn đại diện, rồi chuyển đoạn gốc chọn sang bước tiếp.

**Ailoot Ultra · Xếp hạng lại** `POST /v1/rerank` `voyageai/rerank-2.5`

[`voyageai/rerank-2.5`](https://ailoot.ai/models/vi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

VoyageAI by MongoDB /`voyageai/rerank-2.5`

### Bắt đầu

rerank-2.5 sắp lại tập ứng viên văn bản cung cấp theo độ liên quan với truy vấn và chỉ dẫn ngôn ngữ tự nhiên tùy chọn. Đây là bộ xếp hạng lại đa ngôn ngữ hướng chất lượng, có ngữ cảnh truy vấn–tài liệu 32,000 token và điểm xếp hạng gắn chỉ số ứng viên gốc.

Đầu vào được chấp nhận

Văn bản

Kết quả

Kết quả đã xếp hạng

### 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

`rerank`

Định dạng đầu ra

json

| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
| --- | --- | --- | --- | --- |
| Trường`documents` | Loại`array` | Yêu cầuBắt buộc | 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 voyageai/rerank-2.5 | Mặc định— |
| Trường`provider` | Loại`schema` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`query` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`session_id` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`top_n` | Loại`integer` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 | Mặc định— |
| Trường`trace` | Loại`schema` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`user` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`documents[].text` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`documents[].image` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |

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

**text\_rerank** · Bắt buộc: query, documents array with minItems1

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, query, documents |
| Tham số`material_types` | Hợp đồngtext |
| Tham số`optional_controls` | Hợp đồngprovider, session\_id, top\_n, trace, user |
| Tham số`multimodal_input_binding` | Hợp đồngnull |

Vòng đời: `synchronous`

Gửi ID mô hình chính xác và giữ lại toàn bộ phản hồi gốc.

### 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ìnhUltra | Biểu mức phí— | Đơn vị tính phí/ 1K token | Phí Đầu vào **$0.0001** / 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 →](https://ailoot.ai/docs/vi/billing/reserve/)

### Ví dụ yêu cầu

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

Cấu trúc yêu cầu chính thức được giữ nguyên; ví dụ trong tài liệuSử dụng dữ liệu yêu cầu thực tế của bạn và giữ lại kết quả đầy đủ

```json
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "query": "What is the capital of France?",
  "top_n": 3
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-2.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```

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

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

json

##### Lưu tất cả kết quả đã hoàn tất

Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.

Giữ lại mọi chỉ số kết quả thực tế, relevance\_score hữu hạn và đối tượng tài liệu gốc. Các chỉ số liên kết với mảng tài liệu gốc. Toàn bộ JSON gốc chỉ được lưu và trả về sau khi quyết toán.

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

Giữ nguyên thao tác ban đầu và phản hồi đầy đủ/một phần; không gửi lại POST.

Trường phản hồi

| Trường | Loại |
| --- | --- |
| Trường`model` | Loạistring |
| Trường`id` | Loạistring |
| Trường`provider` | Loạistring |
| Trường`results[].index` | Loạiinteger |
| Trường`results[].relevance_score` | Loạinumber |
| Trường`results[].document.text` | Loạistring |
| Trường`results[].document.image` | Loạistring |
| Trường`usage.search_units` | Loạiinteger |
| Trường`usage.total_tokens` | Loạiinteger |
| Trường`usage.cost` | Loạinumber |

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ệnTrường bắt buộc, biểu diễn hoặc giá trị không hợp lệ | Bước tiếp theoSửa trường yêu cầu được chỉ ra. |

### Bí danh

#### Bí danh mô hình

**Ailoot Ultra** [`voyageai/rerank-2.5`](https://ailoot.ai/models/vi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=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

[`voyageai/rerank-2.5`](https://ailoot.ai/models/vi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

FAQ · VoyageAI by MongoDB: rerank-2.5

Có những đầu vào và kết quả nào?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank`

Yêu cầu sử dụng những trường nào?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user`

Áp dụng những giới hạn nào?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `top_n.minimum`: `1`

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

## Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

## Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao

Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.

Mã giảm đến 50%

Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.

Chi phí trong lịch sử

Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

[Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/)

## Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại

Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.

Giấy phép bán lại

Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.

Tài liệu trên website

Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

[Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.
