모델

VoyageAI by MongoDB: rerank-3-lite

Markdown · JSON

VoyageAI by MongoDB: rerank-3-lite

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

모델 소개

이 설명은 모델의 기능을 다룹니다. 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

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는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →

요청 예제

Ailoot Ultra · 재순위화

보존된 공식 요청 구조; 문서용 예시실제 요청 자료를 사용하고 결과 전체를 보관하세요
{
  "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
}
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

메서드 경로 별칭

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

관련 호출용 ID

voyageai/rerank-3-lite

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% 프로모션 코드
구매할 때 코드를 넣으면 진행 중 행사에 따라 가격을 다시 계산합니다.
이력의 지출
요청마다 모델, 토큰, 금액을 저장합니다.

구독 선택 · 모델 가격 보기

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

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

상업용 앱
서비스의 유료 기능에 텍스트, 이미지, 영상, 소리 생성을 넣으세요.
리셀러 라이선스
프로젝트 설명과 접근 구조를 보내 사용·재판매의 서면 조건을 요청하세요.
사이트의 문서
연결 전에 공식 이용 조건, 라이선스 계약, 데이터 처리 정책을 읽을 수 있습니다.

리셀러 라이선스 요청 · 공식 이용 조건과 라이선스 계약