Amux AI

Jina Reranker v3

最近更新:2026年11月22日

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

Jina Reranker v3 是基于 Qwen3-0.6B 的 0.6B 参数多语言 Listwise 重排模型,采用 "last but not late"(LBNL)交互机制与 256 维投影头,可在 134,144 token 长上下文内单次对多达 64 篇候选文档并行打分(BEIR 61.94 nDCG@10)。

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

模型规格

属性说明
模型 IDjina/jina-reranker-v3
可用别名jina-reranker-v3
上下文上限134,144 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 或裸名别名 jina-reranker-v3。

querystring必填

检索查询文本。

documentsarray<string | object>必填

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

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

候选文档文本。

top_ninteger

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

return_documentsboolean默认 true

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

max_doc_lengthinteger

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

return_embeddingsboolean默认 false

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

响应

200response

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

400response

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

402response

工作区可用余额不足。

使用说明

为存量 jina-reranker-v3 集成提供无缝兼容。省略 max_doc_length 时单篇文档默认上限为 2,048 token(可设 1–8192);支持 return_embeddings: true 返回 256 维文档向量。新项目建议优先使用同协议升级版 Jina Reranker v3.5。

错误处理

错误响应采用 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",
    "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",
  "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
  }
}