---
title: "排序模型"
method: POST
path: "/v1/rerank"
tags: ["模型调用/排序模型"]
---

# 排序模型

`POST /v1/rerank`

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- object
  - `model` string, required — 模型
  - `query` string, required — 需匹配内容
  - `top_n` integer, required — 排序返回的top文档数量，未指定时默认返回全部候选文档，如果指定的top_n值大于输入的候选document数量，返回全部候选文档
  - `documents` string[], required — 待排序的候选document列表

## Response `200`

- object
  - `results` object[], required — 请求的算法输出内容，是一个结构化的数组。每一个数组中包含一个对应的输入text的算法输出内容
    - `index` integer, required — 本结构中的算法结果对应的document在输入候选documents数组中的位置索引值
    - `relevance_score` number, required — 相似度分数取值0.0-1.0之间（浮点型）
  - `usage` object, required
    - `total_tokens` integer, required

---

[API](https://skmtc.net/agicto/apis/docs-agicto-com.md) · [All operations](https://skmtc.net/agicto/apis/docs-agicto-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agicto/docs-agicto-com/revisions/24c455eca4b1/schema)