Amux AI

Jina Reranker v3.5

最近更新:2026年11月22日

Jina AI 重排模型 Jina Reranker v3.5(jina/jina-reranker-v3.5)的规格参数、排序响应结构与调用示例。

Jina Reranker v3.5 是基于 Qwen3-0.6B 的旗舰多语言 Listwise 重排模型(0.6B 参数),采用混合 3L2G 滑窗与全局注意力架构和 512 维投影头,支持高达 131,072 token 上下文窗口单次联合打分,BEIR 达 63.20 nDCG@10 且推理速度较 v3 提升 1.22×–1.56×,是 jina-reranker-v3 的无缝替代版本。

该模型通过 Rerank Documents(POST /v1/rerank)端点调用,支持通过 Authorization: Bearer <key> 鉴权。

模型规格

属性说明
模型 IDjina/jina-reranker-v3.5
可用别名jina-reranker-v3.5
上下文上限131,072 token
支持输入仅文本(query 字符串与 documents 字符串或 { text } 数组)
返回结构按 relevance_score 降序排列的 results[](含原始 index 与可选 document / embedding)
计费方式按查询与全部候选文档合计输入 token(usage.total_tokens)计费,无输出 token 费用;实时单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/rerank

鉴权

header
Authorizationstring必填

Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。

Content-Typestring必填默认 "application/json"

固定为 application/json。

请求

application/json
modelstring必填

模型标识,支持规范 ID jina/jina-reranker-v3.5 或裸名别名 jina-reranker-v3.5。

querystring必填

检索查询文本。

documentsarray<string | object>必填

待重排的非空候选文档列表,每个元素可为字符串或 { text } 对象。

›documentsarray<string | object>
#1string
#2object
›#2object
textstring

候选文档文本。

top_ninteger

最多返回的顶部结果条数;不传时返回全部文档。

return_documentsboolean默认 true

是否在响应中回传原始文档内容(默认 true)。

max_doc_lengthinteger

单篇文档允许的最大 token 数(1–8192);省略时使用模型默认值(本模型默认 8192)。

return_embeddingsboolean默认 false

是否随相关度分值一并返回 512 维文档向量表示(默认 false)。

响应

200response

重排成功,按相关度降序返回。

400response

请求参数不合法或超出模型限制。

402response

工作区可用余额不足。

使用说明

推荐作为所有新建文本 RAG 重排链路的首选模型。省略 max_doc_length 时单篇文档默认上限为 8,192 token(可设 1–8192);支持 return_embeddings: true 在返回重排分值的同时附带 512 维文档向量;大批量重排时建议将 return_documents 设为 false 以减少响应体积。

错误处理

错误响应采用 OpenAI 标准结构({ "error": { "type", "message", … } })。缺少 query 或 documents、top_n 非正整数或上游校验失败均返回 400 invalid_request;单次请求体超过 32 MB 直接拒绝且不重试。完整错误码见错误与重试。

cURL
curl https://gateway.amux.ai/v1/rerank \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jina/jina-reranker-v3.5",
    "query": "Organic skincare products for sensitive skin",
    "top_n": 2,
    "return_documents": true,
    "documents": [
      "Organic skincare for sensitive skin with aloe vera and chamomile.",
      "New makeup trends focus on bold colors and innovative techniques."
    ]
  }'
{
  "object": "list",
  "model": "jina/jina-reranker-v3.5",
  "results": [
    {
      "index": 0,
      "relevance_score": 0.9421,
      "document": {
        "text": "Organic skincare for sensitive skin with aloe vera and chamomile."
      },
      "embedding": [
        0
      ]
    }
  ],
  "usage": {
    "total_tokens": 42
  }
}