重排序

POST

/v1/rerank

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

请求参数

Authorization

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

返回响应

🟢200

application/json

成功返回重排序结果

Bodyapplication/json

示例

{
    "id": "rerank-abc123",
    "model": "cohere-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

内容审核

常见问题