TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Teks

Rerank Dokumen

Mengurutkan ulang dokumen berdasarkan relevansi terhadap kueri

POST
/v1/rerank

Urutkan ulang dokumen menggunakan model kesamaan semantik. Berguna untuk meningkatkan hasil pencarian dan aplikasi RAG.

Isi Permintaan

Untuk input besar, atur timeout klien HTTP setidaknya 120s. Respons dikembalikan setelah pemrosesan selesai.

modelstringwajib

ID model reranker yang akan digunakan (misalnya, qwen3-vl-rerank).

querystringwajib

Kueri untuk membandingkan peringkat dokumen. Panjang maksimum: 32,000 karakter.

documentsarraywajib

Daftar dokumen (string) untuk diurutkan ulang. Batas: hingga 1,000 dokumen, setiap dokumen hingga 100,000 karakter, dan total karakter dokumen paling banyak 2,000,000.

top_ninteger

Jumlah hasil teratas, dari 1 hingga documents.length. Jika dihilangkan, model yang dipilih menentukan jumlahnya.

return_documentsbooleanbawaan: false

Apakah akan menyertakan teks dokumen asli dalam respons.

Respons

resultsarray

Daftar dokumen yang telah diurutkan beserta skornya.

Setiap hasil berisi:

  • index (integer): Indeks dokumen asli
  • relevance_score (number): Skor relevansi. Rentangnya bergantung pada model yang dipilih.
  • document (string): Teks asli (jika return_documents=true)
modelstring

Model yang digunakan untuk reranking. Dikembalikan jika tersedia.

usageobject

Statistik penggunaan token. Dikembalikan jika tersedia.

Permintaan

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

Respons

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

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

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

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json

Buat Embedding

Sebelumnya

Mengevaluasi Keputusan

Berikutnya