Rerank API

curl https://www.tutujin.com/v1/rerank \
  -H "Authorization: Bearer $TUTUJIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-reranker-8b",
    "query": "Can I return an item after opening it?",
    "documents": [
      "Unopened items can be returned within 7 days of delivery, no reason needed.",
      "Orders ship within 48 hours of payment; holidays push this back.",
      "Opened items without a quality issue cannot be returned without a reason."
    ],
    "top_n": 2
  }'

import os
import requests

docs = [
    "Unopened items can be returned within 7 days of delivery, no reason needed.",
    "Orders ship within 48 hours of payment; holidays push this back.",
    "Opened items without a quality issue cannot be returned without a reason.",
]
r = requests.post(
    "https://www.tutujin.com/v1/rerank",
    headers={"Authorization": f"Bearer {os.environ['TUTUJIN_API_KEY']}"},
    json={
        "model": "qwen3-reranker-8b",
        "query": "Can I return an item after opening it?",
        "documents": docs,
        "top_n": 2,
    },
    timeout=30,
)
r.raise_for_status()
for item in r.json()["results"]:
    print(round(item["relevance_score"], 3), docs[item["index"]])

const docs = [
  'Unopened items can be returned within 7 days of delivery, no reason needed.',
  'Orders ship within 48 hours of payment; holidays push this back.',
  'Opened items without a quality issue cannot be returned without a reason.',
]
const r = await fetch('https://www.tutujin.com/v1/rerank', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TUTUJIN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'qwen3-reranker-8b',
    query: 'Can I return an item after opening it?',
    documents: docs,
    top_n: 2,
  }),
})
if (!r.ok) throw new Error(await r.text())
const { results } = await r.json()
for (const item of results) console.log(item.relevance_score.toFixed(3), docs[item.index])

{
  "results": [
    { "index": 2, "relevance_score": 0.93 },
    { "index": 0, "relevance_score": 0.71 }
  ],
  "usage": { "prompt_tokens": 96, "total_tokens": 96 }
}