aisplice

API 参考

重排序

暂时没有可用模型

目前模型目录里没有模型支持这个接口，本页仅供参考。
POST/v1/rerank

针对一个查询为候选文档列表评分。结果按相关性从高到低返回，并保留每个文档的原始索引。

#请求参数

  • modelstring必填

    实时模型目录中的准确重排模型标识。

  • querystring必填

    用于为候选内容评分的搜索查询或问题。

  • documentsstring[]必填

    待重排的候选文本；应用中应保留其原始顺序。

  • top_ninteger可选

    最多返回的重排结果数量。

  • return_documentsboolean可选

    模型支持时，在结果中包含文档文本。

#相关错误码

  • 400 invalid_request_errorquery 或 documents 缺失、为空，或当前模型不支持。
  • 401Bearer 令牌无效或缺失。这条路径不带 error.code，请按状态码判断。
  • 402 insufficient_user_quota钱包余额不足以覆盖预扣估算。
  • 429密钥级限流。响应体为空，按 Retry-After 等待。若 429 带有 insufficient_user_quota，那是每日消费上限，不是限流。
  • 503 model_not_found模型名不存在，或当前没有健康渠道可以服务它。

完整错误码表 →

#请求示例

curl https://www.aisplice.store/v1/rerank \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_RERANK_MODEL",
    "query": "What is the capital of France?",
    "documents": [
      "Paris is the capital of France.",
      "Berlin is in Germany."
    ],
    "top_n": 2
  }'

#响应

response.json
{
  "results": [
    { "index": 0, "relevance_score": 0.9821 },
    { "index": 1, "relevance_score": 0.1034 }
  ]
}

还是没解决？

把请求 ID 或报错信息发给我们，我们来查。

上一页3D 模型接下来文件上传策略