Rerank API: 검색 결과 재정렬

검색 결과나 후보 문서를 쿼리와의 관련도 순으로 다시 정렬하는 엔드포인트입니다. 각 문서의 relevance_score를 받아 후처리에 사용합니다. 요금은 토큰 사용량 기준이며 최신 단가는 Tokuse 요금 페이지에서 확인하세요.

엔드포인트와 인증

항목	값
메서드	POST
엔드포인트	/v1/rerank
인증	Authorization: Bearer sk-your-tokuse-key
응답 필드	relevance_score

지원 모델

업스트림 rerank 모델을 먼저 개통해야 합니다. 요청의 model에는 개통한 모델 ID를 넣고, 아래 예시의 your-rerank-model은 실제 값으로 바꿔 주세요.

요청 예시

curl https://tokuse.com/v1/rerank \
  -H "Authorization: Bearer sk-your-tokuse-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-rerank-model",
    "query": "한국에서 가장 큰 도시는?",
    "documents": [
      "서울은 한국의 수도이자 최대 도시입니다.",
      "부산은 한국의 항구 도시입니다."
    ]
  }'

응답 예시

{
  "results": [
    {"index": 0, "relevance_score": 0.9621},
    {"index": 1, "relevance_score": 0.3145}
  ]
}

주의 사항과 제한

• 업스트림 rerank 모델을 먼저 개통해야 호출할 수 있습니다.
• relevance_score가 높을수록 쿼리와 문서의 관련도가 높습니다.
• 모델마다 입력 길이와 문서 수 제한이 다릅니다. 대량 요청을 보내기 전에 한도를 확인하세요.
• 점수는 모델마다 분포가 다를 수 있으므로 여러 모델의 점수를 직접 비교하지 마세요.

요금

과금은 쿼리와 문서에 사용된 토큰 수를 기준으로 계산됩니다. 후보 문서가 많을수록 토큰 사용량이 늘어납니다. 실제 단가는 Tokuse 요금 페이지(/pricing)와 업스트림 콘솔에서 확인하세요.