TokenLab

텍스트

문서 재순위화

쿼리와의 관련성에 따라 문서를 재순위화합니다

POST
/v1/rerank

현재 rerank 모델 목록을 확인하려면 GET /v1/models?recommended_for=rerank를 사용하세요. 세부 정보에 rerank 작업이 나열된 모델을 사용해야 합니다.

시맨틱 유사도 모델을 사용하여 문서를 재순위화합니다. 검색 결과 개선 및 RAG 애플리케이션에 유용합니다.

요청 본문

이 엔드포인트는 순위 지정이 완료된 후 반환됩니다. 대규모 문서 세트의 경우 HTTP 클라이언트 타임아웃을 최소 120s로 설정하세요.

modelstring필수

사용할 reranker 모델의 ID입니다 (예: qwen3-vl-rerank).

querystring필수

문서 순위를 매길 기준 쿼리입니다. 최대 길이: 32,000자.

documentsarray필수

재순위화할 문서(문자열) 목록입니다. 제한: 최대 1,000개 문서, 각 문서당 최대 100,000자, 전체 문서 합계 최대 2,000,000자.

top_ninteger

반환할 상위 결과 수이며, 1부터 documents.length까지 지정할 수 있습니다. 생략할 경우 선택한 모델에 따라 결과 수가 결정됩니다.

return_documentsboolean기본값: false

각 결과에 원본 문서 텍스트를 포함할지 여부입니다. 모델 세부 정보에 return_documents가 나열되어 있는 경우에만 전달하세요.

응답

resultsarray

점수가 포함된 순위화된 문서 목록입니다.

각 결과 항목:

  • index (integer): 원본 문서 인덱스
  • relevance_score (number): 관련성 점수입니다. 범위는 선택한 모델에 따라 다릅니다.
  • document (string): 원본 텍스트 (return_documents=true인 경우)
modelstring

재순위화에 사용된 모델입니다. 제공 가능한 경우 반환됩니다.

usageobject

요청에 대해 보고된 사용량 정보입니다(제공 가능한 경우): 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
  }'

응답

Response
{
  "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
  }
}

오류

상태코드원인
400invalid_request필드가 누락되었거나 비어 있거나 위의 제한을 초과했습니다. param에 해당 필드가 표시됩니다
400unsupported_endpoint모델이 이 엔드포인트에 게시되지 않았습니다

기타 상태 코드는 API 오류 처리를 참조하세요.

인증

BearerAuth
AuthorizationBearer <token>

API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.

위치: header

헤더

X-TokenLab-Delivery-Policy?string

요청별 전송 정책입니다. API 키 및 Workspace 기본값을 재정의합니다. 자동으로 TokenLab Verified를 먼저 시도하며, 출력, 요청 수락 또는 영구 리소스 생성 전에 Official 전용으로 한 번 전환될 수 있습니다.

허용 값

  • "auto"
  • "verified"
  • "official"

요청 본문

application/json

응답

application/json

application/json

application/json

application/json

application/json

application/json

application/json