创建重排结果
curl --request POST \
--url https://kaienapi.com/v1/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "bge-reranker-v2-m3",
"query": "如何按日期统计接口用量",
"documents": [
"用量接口支持 start_date 和 end_date",
"模型列表接口返回当前 Key 可用模型",
"图片生成接口返回 URL 或 base64"
]
}
'import requests
url = "https://kaienapi.com/v1/rerank"
payload = {
"model": "bge-reranker-v2-m3",
"query": "如何按日期统计接口用量",
"documents": ["用量接口支持 start_date 和 end_date", "模型列表接口返回当前 Key 可用模型", "图片生成接口返回 URL 或 base64"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bge-reranker-v2-m3',
query: '如何按日期统计接口用量',
documents: ['用量接口支持 start_date 和 end_date', '模型列表接口返回当前 Key 可用模型', '图片生成接口返回 URL 或 base64']
})
};
fetch('https://kaienapi.com/v1/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://kaienapi.com/v1/rerank"
payload := strings.NewReader("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"如何按日期统计接口用量\",\n \"documents\": [\n \"用量接口支持 start_date 和 end_date\",\n \"模型列表接口返回当前 Key 可用模型\",\n \"图片生成接口返回 URL 或 base64\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}Rerank 兼容接口,对初步召回的文档重新排序,使排序结果更贴近 query。
请求格式
使用 application/json。必须包含 model、query 和 documents。
输入方式
documents 接收字符串数组或对象数组。对象数组能携带 id、标题、metadata 等应用字段,结果回填时按原始字段对齐。
读取结果
结果一般按相关性从高到低排列,并返回候选文档的索引和分数。开启 return_documents 时会带回文档内容;关闭后响应体更小。
执行顺序
先用关键词或向量检索召回候选,再调用本接口重排,最后把排名靠前的文档交给模型回答。
POST
/
v1
/
rerank
创建重排结果
curl --request POST \
--url https://kaienapi.com/v1/rerank \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "bge-reranker-v2-m3",
"query": "如何按日期统计接口用量",
"documents": [
"用量接口支持 start_date 和 end_date",
"模型列表接口返回当前 Key 可用模型",
"图片生成接口返回 URL 或 base64"
]
}
'import requests
url = "https://kaienapi.com/v1/rerank"
payload = {
"model": "bge-reranker-v2-m3",
"query": "如何按日期统计接口用量",
"documents": ["用量接口支持 start_date 和 end_date", "模型列表接口返回当前 Key 可用模型", "图片生成接口返回 URL 或 base64"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
model: 'bge-reranker-v2-m3',
query: '如何按日期统计接口用量',
documents: ['用量接口支持 start_date 和 end_date', '模型列表接口返回当前 Key 可用模型', '图片生成接口返回 URL 或 base64']
})
};
fetch('https://kaienapi.com/v1/rerank', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://kaienapi.com/v1/rerank"
payload := strings.NewReader("{\n \"model\": \"bge-reranker-v2-m3\",\n \"query\": \"如何按日期统计接口用量\",\n \"documents\": [\n \"用量接口支持 start_date 和 end_date\",\n \"模型列表接口返回当前 Key 可用模型\",\n \"图片生成接口返回 URL 或 base64\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"type": "<string>",
"code": "<string>"
}
}Authorizations
在请求头中传入:Authorization: Bearer sk-...
Body
application/json
重排请求。根据 query 对初步检索到的候选文档重新排序。
重排模型 ID。
Example:
"bge-reranker-v2-m3"
查询文本。模型会按该问题或意图对 documents 重新评分。
Example:
"如何按日期统计接口用量"
候选文档数组。可传字符串或对象;对象一般包含 text、id、metadata 等字段。
返回前 N 条结果。不传时返回全部排序结果或模型默认数量。
Example:
3
是否在结果中返回原始文档内容。关闭后只返回索引和分数,可减少响应体大小。
Example:
true
Response
重排结果
The response is of type object.