Metin

Belgeleri Yeniden Sırala

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

POST
/v1/rerank

Mevcut yeniden sıralama modellerini listelemek için GET /v1/models?recommended_for=rerank kullanın. Ayrıntılarında rerank işlemini listeleyen bir model kullanın.

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

İstek Gövdesi

Bu endpoint, sıralama tamamlandıktan sonra yanıt verir. Büyük belge kümeleri için HTTP istemcinizin zaman aşımı süresini en az 120s olarak ayarlayın.

modelstringzorunlu

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

querystringzorunlu

Belgelerin sıralanmasında temel alınacak sorgu. Maksimum uzunluk: 32,000 karakter.

documentsarrayzorunlu

Yeniden sıralanacak belgelerin (string) listesi. Sınırlar: 1,000 adede kadar belge, her belge en fazla 100,000 karakter ve toplamda en fazla 2,000,000 belge karakteri.

top_ninteger

Döndürülecek en iyi sonuç sayısı, 1 ile documents.length arasında. Belirtilmezse, sonuç sayısını seçilen model belirler.

return_documentsbooleanvarsayılan: false

Her sonuca orijinal belge metninin dahil edilip edilmeyeceği. Bunu yalnızca model ayrıntılarında return_documents listeleniyorsa gönderin.

Yanıt

resultsarray

Puanlarıyla birlikte sıralanmış belge listesi.

Her sonuç şunları içerir:

  • index (integer): Orijinal belge indeksi
  • relevance_score (number): İlgi düzeyi puanı. Puan aralığı seçilen modele bağlıdır.
  • document (string): Orijinal metin (return_documents=true ise)
modelstring

Yeniden sıralama için kullanılan model. Mevcut olduğunda.

usageobject

İstek için bildirilen kullanım (mevcut olduğunda): Arama başına faturalandırılan modeller için total_tokens veya search_units.

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

Hatalar

DurumKodNeden
400invalid_requestBir alan eksik, boş veya yukarıdaki sınırların üzerinde. param bu alanı belirtir
400unsupported_endpointModel bu endpoint için yayınlanmamış

Diğer durumları API hatalarını işleme bölümünde açıklandığı gibi yönetin.

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

application/json

application/json

application/json