API 레퍼런스
리랭크
아직 지원하는 모델이 없습니다
현재 모델 목록에서 이 경로를 지원하는 모델이 없습니다. 이 페이지는 참고용으로 남겨 둡니다.
POST
/v1/rerank하나의 쿼리를 기준으로 후보 문서 목록에 점수를 매깁니다. 결과는 관련도가 높은 순으로 반환되며 각 문서의 원래 인덱스를 유지합니다.
#요청 파라미터
modelstring필수실시간 모델 목록에 있는 정확한 리랭크 모델 식별자.
querystring필수후보 점수를 매기는 데 쓰는 검색 쿼리 또는 질문.
documentsstring[]필수순위를 매길 후보 텍스트. 애플리케이션에서는 원래 순서를 유지하세요.
top_ninteger선택반환할 순위 결과의 최대 개수.
return_documentsboolean선택지원되는 경우 각 결과에 문서 텍스트를 포함합니다.
#관련 오류
- 400 invalid_request_errorquery 또는 documents가 없거나 비어 있거나 이 모델에서 지원되지 않습니다.
- 401Bearer 토큰이 유효하지 않거나 없습니다. 이 경로에는 error.code가 없으므로 상태 코드로 판단하세요.
- 402 insufficient_user_quota지갑 잔액이 사전 차감 추정액보다 부족합니다.
- 429키별 속도 제한입니다. 본문은 비어 있으며 Retry-After만큼 기다리세요. insufficient_user_quota가 포함된 429는 속도 제한이 아니라 일일 지출 한도입니다.
- 503 model_not_found알 수 없는 모델이거나, 현재 이 모델을 제공하는 정상 채널이 없습니다.
#요청 예시
curl https://www.aisplice.store/v1/rerank \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_RERANK_MODEL",
"query": "What is the capital of France?",
"documents": [
"Paris is the capital of France.",
"Berlin is in Germany."
],
"top_n": 2
}'#응답
response.json
{
"results": [
{ "index": 0, "relevance_score": 0.9821 },
{ "index": 1, "relevance_score": 0.1034 }
]
}아직 해결되지 않았나요?
요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.