重排序

POST

/v1/rerank

根据查询文本对文档列表进行相关性重排序

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Example

{
    "model": "bge-rerank-v3",
    "query": "POLOAPI是什么",
    "documents": [
        "POLOAPI是一个企业级AI网关平台",
        "今天天气不错",
        "POLOAPI支持多种AI模型的统一接入"
    ],
    "top_n": 3,
    "return_documents": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/rerank' \
--header 'X-Request-Id;' \
--header 'X-Tenant-Id;' \
--header 'X-Channel;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "bge-rerank-v3",
    "query": "POLOAPI是什么",
    "documents": [
        "POLOAPI是一个企业级AI网关平台",
        "今天天气不错",
        "POLOAPI支持多种AI模型的统一接入"
    ],
    "top_n": 3,
    "return_documents": true
}'

Responses

🟢200

application/json

成功返回重排序结果

Bodyapplication/json

Example

{
    "id": "rerank-abc123",
    "model": "bge-rerank-v3",
    "results": [
        {
            "index": 0,
            "relevance_score": 0.95,
            "document": {
                "text": "POLOAPI是一个企业级AI网关平台"
            }
        },
        {
            "index": 2,
            "relevance_score": 0.88,
            "document": {
                "text": "POLOAPI支持多种AI模型的统一接入"
            }
        },
        {
            "index": 1,
            "relevance_score": 0.12,
            "document": {
                "text": "今天天气不错"
            }
        }
    ],
    "usage": {
        "prompt_tokens": 30,
        "total_tokens": 30
    }
}

🟠401

Modified at 2026-06-29 08:45:13

内容审核

常见问题