Skip to content

Rerank ​

Bir sorgu ile bir doküman listesi alır ve dokümanları alaka düzeyine göre yeniden sıralar. RAG sistemlerinde, aramadan dönen aday dokümanları en iyiden en kötüye sıralamak için kullanılır.

POST/v1/rerank

İstek parametreleri ​

AlanTipZorunluAçıklama
modelstring✓Rerank modeli (örn. verirerag)
querystring✓Arama sorgusu
documentsdizi✓Sıralanacak metin listesi
top_nintegerYalnızca en iyi N sonucu döndür
return_documentsbooleanSonuçta doküman metnini de döndür
max_chunks_per_docintegerDoküman başına azami parça

Örnek ​

bash
curl https://app.qevron.ai/v1/rerank \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "verirerag",
    "query": "Qevron nasıl kimlik doğrular?",
    "documents": [
      "Qevron istekleri Bearer token ile doğrular.",
      "Hava bugün İstanbul'\''da yağmurlu.",
      "Embedding metni vektöre çevirir."
    ],
    "top_n": 2,
    "return_documents": true
  }'
python
import httpx

resp = httpx.post(
    "https://app.qevron.ai/v1/rerank",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "verirerag",
        "query": "Qevron nasıl kimlik doğrular?",
        "documents": [
            "Qevron istekleri Bearer token ile doğrular.",
            "Hava bugün İstanbul'da yağmurlu.",
            "Embedding metni vektöre çevirir.",
        ],
        "top_n": 2,
        "return_documents": True,
    },
)
print(resp.json())

Yanıt ​

json
{
  "id": "rerank-...",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.987,
      "document": { "text": "Qevron istekleri Bearer token ile doğrular." }
    },
    {
      "index": 2,
      "relevance_score": 0.142,
      "document": { "text": "Embedding metni vektöre çevirir." }
    }
  ],
  "meta": { "tokens": { "input_tokens": 48 } }
}
AlanAçıklama
results[].indexGirdideki orijinal sıra
results[].relevance_scoreAlaka skoru (yüksek = daha alakalı)
results[].documentreturn_documents: true ise doküman metni

Sonuçlar skora göre azalan sırada döner.

Qevron — AI gateway. Arpanet / OpenAI / Anthropic / Gemini uyumlu.