Source: https://ailoot.ai/models/ko/voyageai-rerank-3-lite/
Canonical: https://ailoot.ai/models/ko/voyageai-rerank-3-lite/
Language: ko

# VoyageAI by MongoDB: rerank-3-lite

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

## [VoyageAI by MongoDB: rerank-3-lite](https://ailoot.ai/models/ko/voyageai-rerank-3-lite/)

Voyage rerank-3-lite는 빠른 응답이 필요한 검색에 초점을 맞춰 질의에 대한 후보 텍스트 문서를 점수화하고 재정렬합니다. 관련성 지시와 32,000토큰 질의·문서 창을 지원하므로 검색 및 RAG 워크플로에서 벡터 또는 키워드 검색 이후에 유용합니다.

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

모델 소개

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

Voyage rerank-3-lite는 Voyage Rerank 3 시리즈 중 지연 시간에 초점을 맞춘 버전입니다. 텍스트 질의와 후보 문서를 입력받아 각 질의·문서 쌍을 함께 평가하고 관련성 점수를 순위순으로 반환합니다. 검색의 두 번째 단계에서 사용됩니다. 임베딩 또는 키워드 검색기가 후보를 찾으면 Lite가 순서를 세밀하게 조정합니다. 결과는 검색이나 검색 증강 생성 워크플로에서 사용할 순위입니다.

Rerank 3 Lite에서 달라진 점 제작사는 rerank-2.5-lite보다 긴 문서와 코드 검색이 개선되었다고 강조합니다. 두 Rerank 3 버전 모두 지시 이행과 같은 32K급 컨텍스트를 유지하지만 Lite는 지연 시간에 민감한 애플리케이션을 위해 설계되었습니다. 따라서 관련 결과를 신속히 제공해야 하는 대화형 지식 베이스 검색, 지원 문서 검색, 코드 조회에 실용적인 후보입니다. 더 작은 버전이 더 작은 컨텍스트 창을 뜻한다고 가정하지 말고 실제 자료 모음의 품질 및 응답 시간 요구사항에 따라 선택하세요.

질의로 관련성 안내하기 질의와 함께 자연어 지시를 제공하여 무엇을 관련 있다고 볼지 설명할 수 있습니다. 질문과 관련성 선호사항을 간결하고 일관되게 유지하세요. 소프트웨어 지원 검색에서는 “장치를 초기화하는 절차를 찾으세요. 명시된 하드웨어 리비전에 대한 지침을 우선하세요.”라고 요청할 수 있습니다. 의미가 모호한 제품 이름에는 제품 범주를 포함하여 무관한 의미가 우세해지지 않도록 하세요. 질의의 선호사항은 의미적 점수화를 안내합니다. 후보 목록을 만들기 전에 명시적인 자료 모음 메타데이터를 사용하여 올바른 제품, 문서 버전, 접근 범위를 선택하세요.

텍스트 후보의 짧은 목록 준비하기 입력 문서는 문자열입니다. 원본 자료에서 읽을 수 있는 텍스트를 추출하고 유용한 제목, 소제목, 식별자, 주변 맥락을 보존하세요. 각 입력 위치와 원래 기록 간의 안정적인 매핑을 유지하세요. 문제 해결 문서에서는 분리된 문장 하나만 넣지 말고 증상과 관련 절차를 포함하세요. 소스 코드 검색에서는 함수와 이름이 비슷한 함수들을 구별하는 데 필요한 주변 정보를 포함하세요. 반복적인 탐색 텍스트나 상용구가 유용한 지문을 밀어낸다면 제거하세요.

재정렬기는 받은 문서만 재정렬할 수 있습니다. 첫 검색에서 관련 문서를 전혀 찾지 못했다면 이 단계에서 빠진 후보를 복구할 수 없습니다. 결과가 잘못된 것 같다면 후보 목록과 최종 순서를 모두 살펴보세요. 긴 문서가 많은 주제를 다룬다면 일관된 섹션으로 나누고 상위 문서 참조를 유지하여 출처를 잃지 않고 관련 섹션을 선택할 수 있게 하세요.

컨텍스트 및 요청 한도 제조사의 현재 가이드는 질의 최대값을 8,000토큰, 질의와 각 개별 문서의 합산 최대값을 32,000토큰으로 명시합니다. 후보 문서는 최대 1,000개이며 전체 요청 예산은 600,000토큰입니다. 계산식은 질의 토큰 수에 문서 수를 곱한 값에 모든 문서 토큰 수를 더하는 방식입니다. 따라서 긴 질의는 각 쌍에서 공간을 사용하고 전체 예산에도 반복해서 반영됩니다. 문자, 단어, 토큰을 서로 같은 것으로 취급하지 말고 적절한 모델 토크나이저로 제출 텍스트를 계산하세요.

예를 들어 500토큰 질의와 각 4,000토큰인 문서 100개는 이 계산식에서 450,000 입력 토큰을 차지합니다. 이는 예산 산정 예시이며 권장 후보 목록 크기나 측정된 속도 결과가 아닙니다. 문서화된 잘라내기 옵션은 기본적으로 활성화되어 있어, 초과 길이 텍스트가 점수화 전에 줄어들 수 있습니다. 잘라내기로 일치시켜야 할 핵심 지문이 제거되지 않도록 중요한 섹션을 신중히 준비하세요.

결과 읽고 활용하기 결과는 관련성 점수가 높은 순서대로 정렬됩니다. 각 결과는 문서의 원래 입력 위치를 식별하므로 애플리케이션이 자체 제목, 기록 식별자, 출처를 붙일 수 있습니다. top\_k 설정은 반환할 순위 후보의 수를 제어하며 생략하면 모든 후보가 반환됩니다. 제조사의 REST 인터페이스는 문서 텍스트도 반환할 수 있습니다. 검색 페이지를 표시하거나 답변 생성 단계에 근거를 전달할 때는 선택한 결과와 원래 식별자를 함께 유지하세요.

관련성 점수는 후보가 질의에 얼마나 잘 맞는지 나타내며 후보의 진술이 정확하다는 것을 입증하지는 않습니다. 제외 조건과 문서 버전 차이도 포함하여 상위 항목을 사용자의 실제 질문과 비교하세요. 모든 후보가 무관하더라도 가장 높은 순위의 항목은 존재합니다. 자료 모음의 대표 질의를 사용하여 애플리케이션이 이 경우를 어떻게 처리할지 결정하세요.

업그레이드와 버전 선택 제조사는 rerank-3-lite를 API 의미 체계는 그대로 유지하고 점수는 대응하는 이전 버전의 분포에 맞춰 보정한 rerank-2.5-lite의 업그레이드로 설명합니다. 기존 기록 매핑과 검색 단계를 유지한 다음 기존 점수 임계값에 의존하기 전에 의미 있는 질의로 결과 순서를 비교하세요. 응답 시간이 중요한 검색 환경에는 Lite를 사용하고, 어려운 후보의 관련성이 더 중요하다면 품질 중심 rerank-3 버전을 비교 대상으로 사용하세요.

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

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

VoyageAI by MongoDB /`voyageai/rerank-3-lite`

### 시작하기

Voyage rerank-3-lite는 빠른 응답이 필요한 검색에 초점을 맞춰 질의에 대한 후보 텍스트 문서를 점수화하고 재정렬합니다. 관련성 지시와 32,000토큰 질의·문서 창을 지원하므로 검색 및 RAG 워크플로에서 벡터 또는 키워드 검색 이후에 유용합니다.

허용 입력

텍스트

결과

순위가 매겨진 결과

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

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

입력

`text`

출력

`rerank`

출력 형식

json

| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
| --- | --- | --- | --- | --- |
| 필드`documents` | 유형`array` | 요건필수 | 값과 한도 | 기본값— |
| 필드`model` | 유형`string` | 요건필수 | 값과 한도 voyageai/rerank-3-lite | 기본값— |
| 필드`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.00004** / 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-3-lite",
  "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-3-lite'
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-3-lite`](https://ailoot.ai/models/ko/#m=voyageai%2Frerank-3-lite&route=Ultra&caller=voyageai%2Frerank-3-lite&fmt=rerank)

#### 메서드 경로 별칭

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

#### 관련 호출용 ID

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

FAQ · VoyageAI by MongoDB: rerank-3-lite

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

`POST /v1/rerank` · `voyageai/rerank-3-lite`: `text` → `rerank`

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

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

어떤 제한이 적용되나요?

`POST /v1/rerank` · `voyageai/rerank-3-lite`: `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 접근에 활용합니다.