Qwen3 Reranker 8B
Qwen3 Reranker 8B는 검색 질의를 기준으로 제공된 텍스트 문서에 순위를 매깁니다. 질의와 후보 문단을 함께 qwen/qwen3-reranker-8b로 Rerank 엔드포인트에 보낸 뒤, 반환된 관련성 점수와 원래 문서 인덱스를 사용해 검색 결과, 지식베이스 답변, 검색 작업 흐름에 사용할 자료를 선택하세요.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Qwen3 Reranker 8B는 정확한 ID qwen/qwen3-reranker-8b로 사용할 수 있는 텍스트 재순위 모델입니다. 질의와 후보 문서 모음을 받아 관련성 순위를 반환합니다. 초기 검색과 선택된 문단을 사용하는 애플리케이션 사이에 두면 실용적입니다. 먼저 일치할 가능성이 있는 자료를 검색하고, 실제 질문을 기준으로 다시 순위를 매긴 뒤, 선택한 원본 텍스트를 다음 단계로 전달하세요.
model, query, documents를 포함하는 JSON 본문으로 POST /v1/rerank를 보내세요. model을 qwen/qwen3-reranker-8b로 설정하고, 검색 질문을 문자열로 제공하며, 후보 문단을 비어 있지 않은 텍스트 문자열 배열에 넣으세요. 반환된 index는 원래 위치로 문서를 식별하므로 입력 배열 순서와 자체 문서 식별자를 함께 보관하세요. 제품명, 정책 조건, 기술 문단처럼 관련성을 결정하는 자료를 해당 후보에 제공하는 텍스트에 포함하세요.
선택 매개변수 top_n은 최솟값이 1인 정수이며 관련성이 가장 높은 문서를 몇 개 반환할지 선택합니다. 고객 지원 검색에서는 query에 고객의 정확한 질문을, documents에 고객센터의 후보 절을 넣을 수 있습니다. 내부 지식베이스에서는 질문과 함께 절 제목 및 각 결과를 설명할 만큼의 주변 텍스트를 유지한 문단을 사용하세요. 후속 답변이나 검색 화면에 맞는 결과 수를 선택하세요.
공개된 모델 프로필에는 컨텍스트 길이 40,960토큰이 기재되어 있습니다. 요청을 준비할 때 질의와 제공할 문서 텍스트를 고려하고 질문에 유용한 문단을 선택하세요. 재순위 지정은 점수와 원본 선택 결과를 생성합니다. 다른 단계에서 답변이나 인용문을 작성해야 한다면 선택된 문서 텍스트를 사용하세요.
작업은 완전한 JSON 응답을 반환합니다. 반환된 관련성 순서로 results를 읽고, 각 결과의 index, relevance_score, 반환된 document 내용을 보관하며, 응답의 model, identifier, usage 필드가 있으면 함께 보관하세요. 원본을 제시하거나 답변을 조합하기 전에 인덱스를 원래 문서에 연결하세요. 전달이 중단되면 원래 응답과 요청 식별 정보를 저장하여 같은 불확실한 작업을 다시 제출하지 않고 기존 결과를 조사할 수 있게 하세요.
Ailoot Ultra · Rerank POST /v1/rerank qwen/qwen3-reranker-8b
qwen/qwen3-reranker-8b시작하기
Qwen3 Reranker 8B는 검색 질의를 기준으로 제공된 텍스트 문서에 순위를 매깁니다. 질의와 후보 문단을 함께 qwen/qwen3-reranker-8b로 Rerank 엔드포인트에 보낸 뒤, 반환된 관련성 점수와 원래 문서 인덱스를 사용해 검색 결과, 지식베이스 답변, 검색 작업 흐름에 사용할 자료를 선택하세요.
- 허용 입력
- 텍스트
- 결과
- ranking
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot Ultra · Rerank POST /v1/rerank
- 입력
text- 출력
ranking- 출력 형식
- JSON
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 qwen/qwen3-reranker-8b | 기본값— |
필드query | 유형string | 요건필수 | 값과 한도 | 기본값— |
필드documents | 유형array | 요건필수 | 값과 한도 | 기본값— |
필드top_n | 유형integer | 요건선택 사항 | 값과 한도 최솟값: 1 | 기본값— |
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수content_type | 명세application/json |
매개변수required | 명세model, query, documents |
매개변수optional | 명세top_n |
매개변수material_types | 명세text |
매개변수conditions | 명세 |
수명 주기: synchronous_json
요금
요금 정보는 요청 옵션을 추가하지 않습니다. 지원되는 매개변수는 선택한 메서드에 표시됩니다.
- 빠른 모드
- 미지정 빠른 모드를 선택한 경우
- Flex 모드
- 미지정 flex 모드를 선택한 경우
- 최대 추론 수준
- 미지정 최대 추론 수준에 default 조정값을 적용하는 경우
Ailoot 요금
설정별 가격
각 요금을 표시된 조건과 대조하세요. 서로 대체되는 설정 묶음마다 하나의 요금만 적용하세요.
| 설정 | 요금표 | 과금 단위 | 요금 |
|---|---|---|---|
| 설정기본 토큰 요금 | 요금표기본 요금 | 과금 단위— | 요금 입력 · 입력 토큰 — / 1K 토큰 출력 · 출력 토큰 — / 1K 토큰 입력 · 캐시 읽기 — / 1K 토큰 입력 · 캐시 쓰기 — / 1K 토큰 입력 · 캐시 쓰기, 1시간 — / 1K 토큰 |
| 설정입력 토큰 | 요금표— | 과금 단위/ 1K 토큰 | 요금 입력 $0.0004 / 1K 토큰 |
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot Ultra · Rerank
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"documents": ["Paris is the capital of France.", "Berlin is the capital of Germany."], "model": "qwen/qwen3-reranker-8b", "query": "What is the capital of France?", "top_n": 3}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
# Submit once. Retain the complete result, original identifiers and every response header.
결과 수신 및 저장
Ailoot Ultra · Rerank
JSON
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
Retain the complete response, all actual results, original identifiers, usage and response headers.
원래 응답을 확인해야 할 경우
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
응답 필드
| 필드 | 유형 |
|---|---|
필드results | 유형array |
별칭
모델 별칭
Ailoot Ultra qwen/qwen3-reranker-8b
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Qwen3 Reranker 8B
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/rerank·qwen/qwen3-reranker-8b:text→ranking- 요청은 어떤 필드를 사용하나요?
POST /v1/rerank·qwen/qwen3-reranker-8b:model,query,documents,top_n- 어떤 제한이 적용되나요?
POST /v1/rerank·qwen/qwen3-reranker-8b:top_n.minimum:1