텍스트
문서 재순위화
쿼리와의 관련성에 따라 문서를 재순위화합니다
현재 rerank 모델 목록을 확인하려면 GET /v1/models?recommended_for=rerank를 사용하세요. 세부 정보에 rerank 작업이 나열된 모델을 사용해야 합니다.
시맨틱 유사도 모델을 사용하여 문서를 재순위화합니다. 검색 결과 개선 및 RAG 애플리케이션에 유용합니다.
요청 본문
이 엔드포인트는 순위 지정이 완료된 후 반환됩니다. 대규모 문서 세트의 경우 HTTP 클라이언트 타임아웃을 최소 120s로 설정하세요.
사용할 reranker 모델의 ID입니다 (예: qwen3-vl-rerank).
문서 순위를 매길 기준 쿼리입니다. 최대 길이: 32,000자.
재순위화할 문서(문자열) 목록입니다. 제한: 최대 1,000개 문서, 각 문서당 최대 100,000자, 전체 문서 합계 최대 2,000,000자.
반환할 상위 결과 수이며, 1부터 documents.length까지 지정할 수 있습니다. 생략할 경우 선택한 모델에 따라 결과 수가 결정됩니다.
false각 결과에 원본 문서 텍스트를 포함할지 여부입니다. 모델 세부 정보에 return_documents가 나열되어 있는 경우에만 전달하세요.
응답
점수가 포함된 순위화된 문서 목록입니다.
각 결과 항목:
index(integer): 원본 문서 인덱스relevance_score(number): 관련성 점수입니다. 범위는 선택한 모델에 따라 다릅니다.document(string): 원본 텍스트 (return_documents=true인 경우)
재순위화에 사용된 모델입니다. 제공 가능한 경우 반환됩니다.
요청에 대해 보고된 사용량 정보입니다(제공 가능한 경우): total_tokens, 또는 검색 단위로 과금되는 모델의 경우 search_units.
요청
curl -X POST "https://api.tokenlab.sh/v1/rerank" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3-vl-rerank",
"query": "What is machine learning?",
"documents": [
"Machine learning is a subset of AI",
"The weather is nice today",
"Deep learning uses neural networks"
],
"top_n": 2,
"return_documents": true
}'응답
{
"results": [
{
"index": 0,
"relevance_score": 0.95,
"document": "Machine learning is a subset of AI"
},
{
"index": 2,
"relevance_score": 0.82,
"document": "Deep learning uses neural networks"
}
],
"model": "qwen3-vl-rerank",
"usage": {
"total_tokens": 45
}
}오류
| 상태 | 코드 | 원인 |
|---|---|---|
400 | invalid_request | 필드가 누락되었거나 비어 있거나 위의 제한을 초과했습니다. param에 해당 필드가 표시됩니다 |
400 | unsupported_endpoint | 모델이 이 엔드포인트에 게시되지 않았습니다 |
기타 상태 코드는 API 오류 처리를 참조하세요.
인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
헤더
요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.
허용 값
- "auto"
- "verified"
- "official"
요청 본문
application/json
응답
application/json
application/json
application/json
application/json
application/json
application/json
application/json