Skip to main content

Calling Guide

Request Parameters

string
required
Model ID. See “Available Models” below.
string
required
Query text.
array
required
Array of candidate documents, reordered by relevance to query.
integer
required
The number of most relevant documents to return, an integer from 1 to the number of documents. To get all documents ranked, pass the number of documents. Some models return a 400 or 422 error when top_n is omitted.

Available Models

  • bce-reranker-base
  • gte-rerank-v2
  • qwen3-reranker-0.6b
  • qwen3-reranker-4b
  • qwen3-reranker-8b
  • jina-reranker-m0
  • jina-colbert-v2
  • jina-reranker-v3
  • jina-reranker-v3.5
  • cohere-rerank-v4.0-fast
  • cohere-rerank-v4.0-pro
For the latest list, query the Models API: GET https://aihubmix.com/api/v1/models?type=rerank.
Last updated: 2026-10-13