重排序接口
重排序模型
TLDR：使用 Rerank API 对文档进行相关性重排序，提升检索质量。
重排序
请求
POST /v1/rerank请求头
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Content-Type | 是 | string | 固定为 application/json |
Authorization | 是 | string | Bearer token 认证 |
请求体
{
"model": "[模型ID：请通过 Models API 查询]",
"query": "用户查询",
"documents": [
"文档1内容",
"文档2内容",
"文档3内容"
],
"top_n": 3
}参数说明
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
model | 是 | string | 重排序模型名称。具体支持的 Rerank 模型 ID 请通过 Models API 查询，或联系客服确认。 |
query | 是 | string | 用户查询文本 |
documents | 是 | array | 待排序的文档列表 |
top_n | 否 | number | 返回前 N 个最相关的文档 |
示例
curl
Python
Node.js
响应
{
"results": [
{
"index": 0,
"relevance_score": 0.95,
"document": "人工智能是计算机科学的一个分支"
},
{
"index": 2,
"relevance_score": 0.88,
"document": "机器学习是人工智能的核心技术"
}
]
}响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
index | number | 文档在原始列表中的索引 |
relevance_score | number | 相关性分数（0-1） |
document | string | 文档内容 |
错误处理
400 Bad Request
{
"error": {
"message": "Invalid request: 'query' is a required field.",
"type": "invalid_request_error",
"code": 400
}
}401 Unauthorized
{
"error": {
"message": "Invalid API key provided.",
"type": "authentication_error",
"code": 401
}
}使用场景
RAG 应用示例
搜索结果优化