重排序与内容审核

重排序（Rerank）

重排序用于对检索候选结果做相关性二次排序：给定查询 query 与候选文档 documents，返回按相关性从高到低排列的结果，常用于 RAG 检索的精排阶段。

请求

POST https://confluia.com/v1/rerank
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "你的重排序模型 ID",
  "query": "如何申请退款",
  "documents": [
    "退款流程：登录控制台……",
    "发票申请流程：……",
    "联系客服的方式：……"
  ],
  "top_n": 2
}

主要参数

参数	类型	必填	说明
model	string	✓	重排序模型 ID，见 GET /v1/models 或控制台模型列表
query	string	✓	查询文本
documents	array	✓	候选文档，字符串数组或对象数组（如 [{"text": "..."}]）
top_n	int	—	只返回相关性最高的前 N 条；缺省返回全部
return_documents	boolean	—	结果中是否回带文档原文，缺省 false

响应

{
  "results": [
    { "index": 0, "relevance_score": 0.98 },
    { "index": 2, "relevance_score": 0.41 }
  ],
  "usage": { "total_tokens": 123 }
}

• results 按 relevance_score 从高到低排列。
• index 为候选文档在请求 documents 中的下标（从 0 开始），用于映射回你的数据。
• return_documents 为 true 时，每个结果附带 document 字段（回带的原文）。
• 计费按输入 token 数（query + 全部 documents）折算，见响应 usage。

内容审核（Moderations）

对文本做安全分类，兼容 OpenAI 的 POST /v1/moderations 规范。

请求

POST https://confluia.com/v1/moderations
Authorization: Bearer sk-你的密钥
Content-Type: application/json

{
  "model": "omni-moderation-latest",
  "input": "需要审核的文本"
}

响应

results[0].flagged 为是否命中任一风险类别的布尔值，results[0].categories 给出各类别的逐项布尔结果。input 也可传字符串数组做批量审核。

暂未开放的接口

以下 OpenAI 接口当前不可用，请勿在接入代码中依赖：

接口	调用结果
/v1/files（文件上传）、/v1/images/variations（图像变体）、/v1/fine-tunes（微调）	501 Not Implemented，error.code 为 api_not_implemented
/v1/batches（批处理）、Assistants 等	路径未注册，返回 404

如确需上述能力，请提交工单说明使用场景。

认证与错误

认证方式与其他接口一致：Authorization: Bearer sk-你的密钥。错误结构与状态码约定见错误码与限流。