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

# VoyageAI by MongoDB: rerank-2.5

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

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

rerank-2.5는 제공한 텍스트 후보 집합을 질의와 선택적인 자연어 지시에 대한 관련성순으로 재정렬합니다. 32,000토큰 질의·문서 컨텍스트를 갖춘 다국어 품질 중심 재정렬기로, 원래 후보 인덱스와 연결된 순위 점수를 반환합니다.

- [**Ailoot Ultra · 재순위화** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/ko/voyageai-rerank-2-5/#method-0)

모델 소개

이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.

rerank-2.5는 검색 후보 집합을 세밀하게 조정하도록 설계된 Voyage AI의 지시 이행 재정렬기입니다. 크로스 인코더로서 질의와 각 문서를 함께 살펴본 다음 관련성 순서를 반환합니다. 제조사의 릴리스는 무엇을 관련 있다고 볼지에 대한 자연어 제어, 다국어 검색, 이전 rerank-2 버전보다 긴 질의·문서 컨텍스트를 강조합니다.

#### 비교할 후보를 모델에 제공하기

입력은 질의와 후보 텍스트 문서 목록입니다. 임베딩 검색이나 어휘 기반 1단계 검색이 선택한 지문일 수 있습니다. 재정렬기는 문서 집합의 임베딩을 만드는 대신 제공한 텍스트를 평가하므로, 실제 역할은 최초 검색이 이미 찾은 후보를 더 세밀하게 정리하는 것입니다.

목록을 준비할 때 원래 후보 순서와 출처 식별자를 유지하세요. 반환된 인덱스는 해당 입력 위치를 가리킵니다. RAG 작업에서는 제목이나 해석에 필요한 적용 조건을 포함하여 답변 단계에서 실제로 사용할 수 있는 지문을 제공하세요. 제출한 후보 집합에 없는 관련 문서는 재정렬을 통해 새로 발견된 결과로 나타날 수 없습니다.

#### 의도한 관련성의 의미 지정하기

질의 뒤나 앞에 지시를 붙일 수 있습니다. 릴리스는 문서의 특정 부분 강조, 출처 유형 선호, 애플리케이션 맥락으로 질의의 모호성 해소라는 세 가지 유용한 역할을 설명합니다. 이는 모델에 제시하는 관련성 작업을 바꿉니다.

기술 검색용 지시의 예는 “실패와 복구 동작을 설명하는 지문을 우선하세요. 입문 개요는 부차적입니다.”입니다. 조사 자료 모음에서는 제목, 방법, 결과 중 무엇이 가장 중요한지 지정하세요. 모호한 용어에는 검색의 주제 분야를 명시하세요. 한쪽은 넓은 주제를 요청하고 다른 쪽은 알리지 않고 작업을 바꾸지 않도록 질문과 지시를 서로 양립하게 유지하세요.

이러한 선호사항은 관련성 점수화를 안내합니다. 애플리케이션에 출처 버전, 날짜, 접근 범위 같은 엄격한 적격 요건이 있다면 적격 후보 집합을 별도로 준비하세요. 모델의 관련성 지시와 규칙에 따라 확정적으로 적용되는 자료 모음 제한은 서로 다른 목적을 갖습니다.

#### 순위 출력과 후속 결과 활용

결과는 관련성이 높은 순서로 정렬되며 부동소수점 관련성 점수와 후보의 원래 입력 인덱스를 포함합니다. top-k 옵션은 반환할 상위 결과 수를 선택합니다. 생략하면 제조사 사양에 따라 제출한 모든 후보의 결과를 반환합니다. 선택적인 return-documents 설정은 해당 원본 텍스트를 포함하고, 그렇지 않으면 응답에는 인덱스와 점수가 들어갑니다.

순서를 사용하여 표시하거나 후속 답변 단계에 전달할 지문을 선택하되 출처 식별 정보를 온전히 유지하세요. 순위를 평가할 때 실제 텍스트를 살펴보세요. 점수는 제출한 질의에 대한 관련성 척도이며 생성된 답변이나 문서 주장의 정확성 검증이 아닙니다. 따라서 이 모델은 순위 산정을 해당 분야의 결론으로 바꾸지 않으면서 기술, 법률, 금융, 의료, 대화, 다국어 검색 자료를 더 세밀하게 정리하는 데 유용합니다.

#### 컨텍스트, 전체 토큰 예산, 잘라내기

문서화된 질의 한도는 질의에 배치한 지시를 포함하여 8,000토큰입니다. 질의와 후보 문서 하나의 합은 32,000토큰 이내여야 하며 문서 목록에는 최대 1,000개 항목을 포함할 수 있습니다. 전체 허용량은 600,000토큰으로, 질의 토큰 수에 문서 수를 곱한 값에 모든 문서 토큰 수를 더해 계산합니다. 따라서 긴 지시는 후보 쌍마다 반복 계산됩니다.

출력 top-k 수는 해당 입력 토큰 계산의 후보 수를 바꾸지 않습니다. 기본 잘라내기는 길이를 초과한 질의나 문서를 줄여 컨텍스트 한도에 맞춥니다. 이를 비활성화하면 초과 길이 질의나 쌍에 오류가 반환됩니다. 답변을 담은 지문을 신중히 준비하고 모델이 보게 될 텍스트 안에 관련 적용 조건을 유지하세요. 대표 질문과 지시로 개선된 순서를 평가한 다음 선택한 원본 지문을 다음 단계에 전달하세요.

**Ailoot Ultra · 재순위화** `POST /v1/rerank` `voyageai/rerank-2.5`

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

VoyageAI by MongoDB /`voyageai/rerank-2.5`

### 시작하기

rerank-2.5는 제공한 텍스트 후보 집합을 질의와 선택적인 자연어 지시에 대한 관련성순으로 재정렬합니다. 32,000토큰 질의·문서 컨텍스트를 갖춘 다국어 품질 중심 재정렬기로, 원래 후보 인덱스와 연결된 순위 점수를 반환합니다.

허용 입력

텍스트

결과

순위가 매겨진 결과

### Ailoot에서 사용 가능 · 입력 및 메서드

**Ailoot Ultra · 재순위화** `POST /v1/rerank`

입력

`text`

출력

`rerank`

출력 형식

json

| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
| --- | --- | --- | --- | --- |
| 필드`documents` | 유형`array` | 요건필수 | 값과 한도 | 기본값— |
| 필드`model` | 유형`string` | 요건필수 | 값과 한도 voyageai/rerank-2.5 | 기본값— |
| 필드`provider` | 유형`schema` | 요건선택 사항 | 값과 한도 | 기본값— |
| 필드`query` | 유형`string` | 요건필수 | 값과 한도 | 기본값— |
| 필드`session_id` | 유형`string` | 요건선택 사항 | 값과 한도 | 기본값— |
| 필드`top_n` | 유형`integer` | 요건선택 사항 | 값과 한도 최솟값: 1 | 기본값— |
| 필드`trace` | 유형`schema` | 요건선택 사항 | 값과 한도 | 기본값— |
| 필드`user` | 유형`string` | 요건선택 사항 | 값과 한도 | 기본값— |
| 필드`documents[].text` | 유형`string` | 요건선택 사항 | 값과 한도 | 기본값— |
| 필드`documents[].image` | 유형`string` | 요건선택 사항 | 값과 한도 | 기본값— |

입력 자료 조합

**text\_rerank** · 필수: query, documents array with minItems1

메서드 매개변수와 수명 주기

| 매개변수 | 명세 |
| --- | --- |
| 매개변수`content_type` | 명세application/json |
| 매개변수`required` | 명세model, query, documents |
| 매개변수`material_types` | 명세text |
| 매개변수`optional_controls` | 명세provider, session\_id, top\_n, trace, user |
| 매개변수`multimodal_input_binding` | 명세null |

수명 주기: `synchronous`

정확한 모델 ID를 전송하고 네이티브 응답 전체를 보존하세요.

### 요금

요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.

빠른 모드

미지정 빠른 모드를 선택한 경우

Flex 모드

미지정 flex 모드를 선택한 경우

최대 추론 수준

미지정 최대 추론 수준에 default 조정값을 적용하는 경우

#### Ailoot 요금

#### 설정별 가격

각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.

| 설정 | 요금표 | 과금 단위 | 요금 |
| --- | --- | --- | --- |
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 **—** / 1K 토큰 출력 · 출력 토큰 **—** / 1K 토큰 입력 · 캐시 읽기 **—** / 1K 토큰 입력 · 캐시 쓰기 **—** / 1K 토큰 입력 · 캐시 쓰기, 1시간 **—** / 1K 토큰 |
| 설정Ultra | 요금표— | 과금 단위/ 1K 토큰 | 요금 입력 **$0.0001** / 1K 토큰 |

Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. [금액 확보와 정산 방식 →](https://ailoot.ai/docs/ko/billing/reserve/)

### 요청 예제

#### Ailoot Ultra · 재순위화

보존된 공식 요청 구조; 문서용 예시실제 요청 자료를 사용하고 결과 전체를 보관하세요

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

### 결과 수신 및 저장

#### Ailoot Ultra · 재순위화

json

##### 완료된 결과 모두 보관

반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.

모든 실제 결과 인덱스, 유한한 relevance\_score 및 원본 문서 객체가 보존됩니다. 인덱스는 원본 문서 배열과 연결됩니다. 원본 JSON 전체는 정산이 끝난 후에만 저장되고 반환됩니다.

##### 원래 응답을 확인해야 할 경우

원래 작업과 전체/부분 응답을 보존하세요. POST를 재전송하지 마세요.

응답 필드

| 필드 | 유형 |
| --- | --- |
| 필드`model` | 유형string |
| 필드`id` | 유형string |
| 필드`provider` | 유형string |
| 필드`results[].index` | 유형integer |
| 필드`results[].relevance_score` | 유형number |
| 필드`results[].document.text` | 유형string |
| 필드`results[].document.image` | 유형string |
| 필드`usage.search_units` | 유형integer |
| 필드`usage.total_tokens` | 유형integer |
| 필드`usage.cost` | 유형number |

오류와 다음 단계

| 응답 | 조건 | 다음 단계 |
| --- | --- | --- |
| 응답400 · `invalid_request_error` | 조건필수 필드, 표현 형식 또는 값이 유효하지 않음 | 다음 단계표시된 요청 필드를 수정하세요. |

### 별칭

#### 모델 별칭

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

#### 메서드 경로 별칭

위에 표시된 메서드 경로를 사용하세요.

#### 관련 호출용 ID

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

FAQ · VoyageAI by MongoDB: rerank-2.5

어떤 입력과 결과를 사용할 수 있나요?

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

요청은 어떤 필드를 사용하나요?

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

어떤 제한이 적용되나요?

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

Claude Code, OpenCode, Hermes, 자체 앱에 Ailoot를 연결하세요.

## 회사와 그 프로젝트 포트폴리오

회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.

## 할인받아 토큰을 구매하세요.

정기 작업에는 구독 할인, 토큰 구매에는 최대 50% 프로모션 코드.

구독

정기 요청에 맞는 할인 요금제를 선택하세요.

최대 50% 프로모션 코드

구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.

이력의 지출

요청마다 모델, 토큰, 금액을 저장합니다.

[구독 선택](https://ailoot.ai/docs/ko/billing/subscriptions/) · [모델 가격 보기](https://ailoot.ai/models/ko/)

## 판매하는 제품에 API를 연결하세요.

Ailoot 공식 이용 조건과 라이선스 계약으로 SaaS, 앱, 봇에 사용하세요. 재판매에는 리셀러 라이선스를 요청하세요.

상업용 앱

서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.

리셀러 라이선스

프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.

사이트의 문서

연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

[리셀러 라이선스 요청](mailto:support@ailoot.ai) · [공식 이용 조건과 라이선스 계약](https://ailoot.ai/legal/offer?lang=ko)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.