Rerank

The Rerank API reorders search results based on semantic relevance.

Endpoint

POST https://ai-tokenhub.com/v1/rerank

Request Body

Parameter	Type	Required	Description
model	string	Yes	Rerank model identifier
query	string	Yes	Query text
documents	array	Yes	Documents to rerank
top_n	integer	No	Number of results to return

Request Example

curl https://ai-tokenhub.com/v1/rerank \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "rerank-3",
    "query": "What is AI?",
    "documents": ["AI is...", "ML is...", "DL is..."],
    "top_n": 3
  }'

Response Example

{
  "object": "list",
  "results": [
    {
      "index": 0,
      "document": "AI is...",
      "relevance_score": 0.95
    }
  ]
}

Use Cases

• Search Optimization: Improve relevance
• Recommendation Ranking: Optimize recommendations
• Q&A Systems: Find most relevant answers