TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Metin

Dokümanları Yeniden Sırala

Dokümanları bir sorguyla olan ilgi düzeyine göre yeniden sıralar

POST
/v1/rerank

Semantik benzerlik modellerini kullanarak dokümanları yeniden sıralayın. Arama sonuçlarını ve RAG uygulamalarını iyileştirmek için kullanışlıdır.

İstek Gövdesi

Büyük girdiler için HTTP istemcisi zaman aşımını en az 120s olarak ayarlayın. İşleme tamamlandığında yanıt döner.

modelstringzorunlu

Kullanılacak reranker modelinin kimliği (örneğin, qwen3-vl-rerank).

querystringzorunlu

Dokümanların sıralanacağı sorgu. Maksimum uzunluk: 32,000 karakter.

documentsarrayzorunlu

Yeniden sıralanacak dokümanların (dizelerin) listesi. Sınırlar: en fazla 1,000 doküman, her doküman en fazla 100,000 karakter ve toplamda en fazla 2,000,000 doküman karakteri.

top_ninteger

Döndürülecek en iyi sonuç sayısı, 1 ile documents.length arasındadır. Atlanırsa sayıyı seçilen model belirler.

return_documentsbooleanvarsayılan: false

Orijinal doküman metninin yanıtta yer alıp almayacağı.

Yanıt

resultsarray

Puanlarıyla birlikte sıralanmış doküman listesi.

Her sonuç şunları içerir:

  • index (integer): Orijinal doküman dizini
  • relevance_score (number): İlgililik puanı. Aralığı seçilen modele bağlıdır.
  • document (string): Orijinal metin (eğer return_documents=true ise)
modelstring

Yeniden sıralama için kullanılan model. Varsa döndürülür.

usageobject

Token kullanım istatistikleri. Varsa döndürülür.

İstek

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
  }'

Yanıt

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": {
    "prompt_tokens": 45,
    "total_tokens": 45
  }
}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

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

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

Embedding Oluştur

Önceki

Kararları Değerlendirme

Sonraki