bge-reranker-v2-m3
질의에 대해 후보 구절의 순위를 매기는 BAAI의 다국어 크로스 인코더입니다. 각 질의·구절 쌍을 함께 읽고 관련성 점수를 반환하여, 답변 생성이나 문서 임베딩 생성 없이 검색 후보 목록을 정교하게 다듬습니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
BGE Reranker v2 M3는 BGE-M3를 기반으로 구축한 다국어 관련성 모델입니다. 질의와 후보 구절을 함께 입력받아 둘의 관계에 대한 점수를 반환합니다. BAAI는 검색 애플리케이션이 기존 후보 목록을 정교하게 다듬어야 하는 중국어 및 영어 검색 등을 위한 효율적인 다국어 리랭커로 이 에디션을 포지셔닝합니다.
질의·구절 쌍의 관련성
크로스 인코더는 두 텍스트를 함께 처리하므로 관련성 점수를 생성하기 전에 내용이 상호작용할 수 있습니다. 이는 재사용 가능한 벡터 비교를 위해 텍스트를 각각 인코딩하는 임베딩 모델과 다릅니다. 리랭커의 출력은 문서 벡터나 글로 된 답변이 아닌 특정 쌍의 스칼라 점수입니다.
초기 검색에서 타당한 후보 구절을 선택한 뒤 모델을 사용하세요. 질문을 각 후보와 짝지어 결과 점수로 후보의 순서를 정하세요. 이렇게 하면 크로스 인코더에 대규모 컬렉션의 모든 구절을 살펴보게 하는 대신, 관리 가능한 후보 목록에 더 세밀한 비교를 집중할 수 있습니다.
v2 M3 에디션
제작사는 BGE-M3를 기반 모델로 명시하고 다국어 지원을 주요 기능으로 제시합니다. v2 리랭커 계열에서 M3는 효율적인 다국어 옵션입니다. Gemma 기반 변형과 레이어 선택 변형은 구현 선택이 다른 별도 모델입니다. 여기서 M3라는 이름은 리랭커가 원래 임베딩 모델의 밀집, 희소, 다중 벡터 임베딩을 반환한다는 뜻이 아닙니다.
애플리케이션에 필요한 결과를 선택할 때 이 구분이 중요합니다. 문서 컬렉션을 표현하고 검색하려면 임베딩 모델을 선택하세요. 이미 후보 텍스트가 있고 현재 질의와 가장 관련된 구절을 결정해야 할 때는 이 리랭커를 선택하세요.
유용하게 순위를 매길 수 있는 후보 준비하기
실제 질문과 후보를 해석하는 데 필요한 전체 텍스트를 제공하세요. 구절의 의미를 결정하는 제목이나 인접 정의를 보존하세요. 공개된 Transformers 예시에서는 잘라내기와 max_length=512를 적용해 질의와 구절을 함께 토큰화합니다. 이는 예시 설정이며 모델 전체에 적용되는 제한은 아닙니다. 선택한 쌍의 허용량 안에 질문과 필수 근거를 넣고 잘라내기로 무엇이 제거되는지 확인하세요. 질의와 같은 제품을 언급하는 결과라도 잘못된 작업이나 조건을 다룬다면 관련성이 없을 수 있습니다. 검색 품질을 평가할 때 이런 사례를 구분하는 예시를 준비하세요.
문서 어시스턴트에서는 후보 식별자를 텍스트와 함께 유지하고, 질문·구절 쌍에 점수를 매긴 뒤 선택한 원래 구절을 답변 단계로 전달하세요. 그러면 답변 모델은 출처 없는 관련성 점수 대신 근거를 받습니다. 이는 검색 워크플로의 예시입니다. 리랭커 자체는 외부 컬렉션을 검색하거나 답변을 작성하지 않습니다.
점수 읽기와 정규화
제조사는 원시 관련성 점수를 반환하며 값이 높을수록 더 가까운 일치를 뜻합니다. 문서화된 선택적 정규화는 시그모이드 함수를 적용해 점수를 0에서 1 사이로 변환합니다. 정규화 점수는 사용하기 편한 범위를 갖지만, 변환만으로 후보가 올바를 확률로 보정되는 것은 아닙니다.
실제 작업을 대표하는 질의·구절 쌍으로 순위 또는 필터링 임곗값을 선택하세요. 키워드는 같지만 다른 질문에 답하는 구절과, 표현은 달라도 관련성이 있는 구절을 포함하세요. 이를 통해 선택한 임곗값이 검색 대상 컬렉션에서 의미를 갖게 됩니다.
Ailoot API 프로젝트에서는 최종 컨텍스트에 무엇을 넣을지, 얼마나 많은 후보를 효율적으로 살펴볼 수 있을지 정의하세요. 유용한 결과는 다음 애플리케이션 단계를 위한 더 잘 정렬된 근거 집합입니다. 이 에디션의 관련성 출력을 문서 임베딩, 생성된 문장, 다른 리랭커에 문서화된 레이어 선택 제어와 구분하세요.
Ailoot Ultra · 재순위화 POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3시작하기
질의에 대해 후보 구절의 순위를 매기는 BAAI의 다국어 크로스 인코더입니다. 각 질의·구절 쌍을 함께 읽고 관련성 점수를 반환하여, 답변 생성이나 문서 임베딩 생성 없이 검색 후보 목록을 정교하게 다듬습니다.
- 허용 입력
- 텍스트
- 결과
- 순위가 매겨진 결과
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · 재순위화 POST /v1/rerank
- 입력
text- 출력
rerank
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 bge-reranker-v2-m3 | 기본값— |
필드query | 유형string | 요건선택 사항 | 값과 한도 | 기본값— |
필드documents | 유형array | 요건필수 | 값과 한도 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, documents |
매개변수material_types | 명세text |
매개변수material_conditions | 명세실제 쿼리와 비어 있지 않은 원본 텍스트 문서 배열을 지정하세요. 결과 인덱스는 이 원본 배열을 가리킵니다. |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정전체 토큰 | 요금표— | 과금 단위/ 1K 토큰 | 요금 입력 · 전체 토큰 $0.00004 / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · 재순위화
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
결과 수신 및 저장
Ailoot Ultra · 재순위화
설정된 응답 모델, 원본 문서 인덱스, 관련성 점수, 문서 문자열 및 네이티브 토큰 사용량이 포함된 원본 네이티브 JSON 결과 전체입니다. 모든 실제 결과 및 사용량 필드를 보존하세요.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
전체 응답과 헤더, 실제로 생성된 모든 출력, 최초로 반환된 식별자와 모든 사용량 필드를 보관하세요. 생성 요청을 다시 제출하지 말고 최초 작업을 복구하세요.
원래 응답을 확인해야 할 경우
실제 X-Client-Request-ID와 응답 전체를 보존하세요. 원래 소유 자산과 해당 자산의 정확한 서명된 콘텐츠 URL을 조회하세요. 생성 여부가 불확실한 요청을 절대로 다시 제출하지 마세요.
응답 필드
| 필드 | 유형 | 의미 |
|---|---|---|
필드model | 유형string | 의미소스 코드에 설정된 처리기가 요구하는 정확한 응답 모델입니다. |
필드results[].index | 유형integer | 의미원본 입력 문서의 고유 인덱스입니다. |
필드results[].relevance_score | 유형number | 의미유한한 관련성 점수입니다. |
필드results[].document | 유형string | 의미설정된 이 응답 처리기가 요구하는 원본 텍스트 문서입니다. |
필드usage.total_tokens | 유형integer | 의미현재 승인된 요금제에서 요구하는 영 이상인 유한한 네이티브 토큰 수입니다. |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건JSON 본문 또는 명시적인 표준 모델 ID가 유효하지 않습니다. | 다음 단계응답을 보존하고 표시된 요청 필드를 수정하세요. |
응답401 · authentication_error | 조건Ailoot API 키가 유효하지 않습니다. | 다음 단계사용 권한이 있는 Ailoot API 키를 사용하세요. |
응답403 · permission_error | 조건이 키 그룹은 해당 메서드를 허용하지 않습니다. | 다음 단계반환된 오류 세부 정보를 보존하세요. |
응답404 · not_found_error | 조건선택한 메서드에는 허용된 경로가 없습니다. | 다음 단계반환된 오류 세부 정보를 보존하세요. |
응답422 · price_unavailable | 조건승인된 요금제에서 필요한 입력 수량 또는 상한을 확보할 수 없습니다. | 다음 단계응답을 보존하세요. 승인된 요금제에서 요구하는 입력 표현 형식을 사용하세요. |
응답503 · | 조건필요한 저장소, 경로, 메서드 요금 또는 예약을 사용할 수 없습니다. | 다음 단계원본 응답 전체를 보존하세요. 예약 여부가 불확실하다고 해서 다시 제출할 수 있는 것은 아닙니다. |
응답502 · billing_requires_check | 조건원래 결과, 사용량 또는 정산을 확인해야 합니다. | 다음 단계실제 요청 ID와 원본 응답을 보존하세요. 기존 소유 기록을 조회하고 생성을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot Ultra bge-reranker-v2-m3
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · bge-reranker-v2-m3
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- 요청은 어떤 필드를 사용하나요?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents