Metin
Belgeleri Yeniden Sırala
Belgeleri bir sorguyla olan ilgi düzeyine göre yeniden sıralar
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.
Kullanılacak reranker modelinin kimliği (örn. qwen3-vl-rerank).
Belgelerin sıralanmasında temel alınacak sorgu. Maksimum uzunluk: 32,000 karakter.
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.
Döndürülecek en iyi sonuç sayısı, 1 ile documents.length arasında. Belirtilmezse, sonuç sayısını seçilen model belirler.
falseHer sonuca orijinal belge metninin dahil edilip edilmeyeceği. Bunu yalnızca model ayrıntılarında return_documents listeleniyorsa gönderin.
Yanıt
Puanlarıyla birlikte sıralanmış belge listesi.
Her sonuç şunları içerir:
index(integer): Orijinal belge indeksirelevance_score(number): İlgi düzeyi puanı. Puan aralığı seçilen modele bağlıdır.document(string): Orijinal metin (return_documents=trueise)
Yeniden sıralama için kullanılan model. Mevcut olduğunda.
İ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
{
"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
| Durum | Kod | Neden |
|---|---|---|
400 | invalid_request | Bir alan eksik, boş veya yukarıdaki sınırların üzerinde. param bu alanı belirtir |
400 | unsupported_endpoint | Model 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 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
İ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