跳转到主要内容
POST
重排序文档
此页面保留原有接口文档,当前可用接口的参数说明尚待核实。
使用 jina-reranker-v3 针对某个 query 对文档列表重排序。需要提供非空的 query 和非空的 documents 数组;结果按 relevance_score 排序返回。可选的 top_n 用于只返回最相关的若干文档。它与基于 embedding 的检索天然互补:先用 embedding 召回候选,再用重排序确定最终顺序。 通过 AIsa API 路径 /v1/rerank 提供服务——OpenAI 兼容。按 token 计费;usage.total_tokens 字段给出每次请求计费的 token 数。

请求规范

  • 方法与路径: POST /rerank
  • 请求 URL 模板: https://api.aisa.one/v1/rerank
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
documents
string[]
必填

要重排序的非空文档字符串数组。

Minimum array length: 1
示例:
model
string
必填

重排序模型名称。

示例:

"jina-reranker-v3"

query
string
必填

用于对文档排序的非空查询字符串。

示例:

"What is the capital of France?"

top_n
integer

可选。只返回相关性最高的前 N 个文档。

示例:

2

响应

200 - application/json

按相关性排序的重排序结果。

model
string
示例:

"jina-reranker-v3"

results
object[]
usage
object