---
title: "Create Rerank"
method: POST
path: "/rerank"
tags: ["Rerank"]
---

# Create Rerank

`POST /rerank`

Creates a rerank request.

## Request body

- RerankRequest
  - `model` 'BAAI/bge-reranker-v2-m3' | 'netease-youdao/bce-reranker-base_v1', required — Specifies the model to be used.
  - `query` string, required — Required. The search query.
  - `documents` string[], required — Required. List of documents to be reordered. If document objects are provided, the 'text' field is mandatory, and other fields will be preserved in the response.
  - `top_n` integer — Number of most relevant documents or indices to return.
  - `return_documents` boolean — If false, the response does not include document text; if true, it includes the input document text.
  - `max_chunks_per_doc` integer — Maximum number of chunks generated from within a document. Long documents are divided into multiple chunks for calculation, and the highest score among the chunks is taken as the document's score.
  - `overlap_tokens` integer — Number of token overlaps between adjacent chunks when documents are chunked.

## Response `200`

200

- RerankResponse
  - `id` string, required
  - `results` object[], required
    - `document` object — Original document content.
      - `text` string
    - `index` integer — The index value of the position in the input candidate doc array.
    - `relevance_score` number — Similarity score.
  - `tokens` object, required
    - `input_tokens` integer
    - `output_tokens` integer

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound
- `429` — RateLimit
- `503` — Overloaded
- `504` — Timeout

---

[API](https://skmtc.dev/siliconflow/apis/siliconflow-api.md) · [All operations](https://skmtc.dev/siliconflow/apis/siliconflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siliconflow/siliconflow-api/revisions/945a814800c3/schema)