Text & Chat
Dokumente neu ordnen (Rerank)
Ordnet Dokumente nach Relevanz für eine Suchanfrage neu
Ordnen Sie Dokumente mithilfe von semantischen Ähnlichkeitsmodellen neu. Nützlich zur Verbesserung von Suchergebnissen und RAG-Anwendungen.
Anfragekörper
Setzen Sie bei großen Eingaben das HTTP-Client-Timeout auf mindestens 120s. Die Antwort erfolgt nach Abschluss der Verarbeitung.
ID des zu verwendenden Reranker-Modells (z. B. qwen3-vl-rerank).
Die Suchanfrage, gegen die die Dokumente bewertet werden sollen. Maximale Länge: 32,000 Zeichen.
Liste der neu zu ordnenden Dokumente (Strings). Limits: bis zu 1,000 Dokumente, jedes Dokument bis zu 100,000 Zeichen und höchstens 2,000,000 Dokumentzeichen insgesamt.
Anzahl der besten Ergebnisse zwischen 1 und documents.length. Ohne Angabe bestimmt das gewählte Modell die Ergebnisanzahl.
falseGibt an, ob der ursprüngliche Dokumenttext in der Antwort enthalten sein soll.
Antwort
Rangliste der Dokumente mit Scores.
Jedes Ergebnis enthält:
index(integer): Ursprünglicher Dokument-Indexrelevance_score(number): Relevanzwert. Der Wertebereich hängt vom gewählten Modell ab.document(string): Ursprünglicher Text (wennreturn_documents=true)
Das für das Reranking verwendete Modell. Wird zurückgegeben, sofern verfügbar.
Statistiken zur Token-Nutzung. Wird zurückgegeben, sofern verfügbar.
Anfrage
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
}'Antwort
{
"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
}
}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Header
Zustellungsrichtlinie pro Anfrage. Überschreibt die API-Key- und Workspace-Standardeinstellungen. Versucht automatisch zuerst TokenLab Verified und kann vor der Ausgabe, der Annahme der Anfrage oder der Erstellung persistenter Ressourcen einmalig auf Official umstellen.
Zulässige Werte
- "auto"
- "verified"
- "official"
Anfragekörper
application/json
Antwort
application/json
application/json
application/json
application/json