Skip to main content

说明

我们集成了 Jina AI 的五个核心接口,助你轻松构建功能强大的智能体。这些接口主要适用于以下场景:
  • 向量嵌入 (Embeddings):适用于多模态 RAG 问答场景,例如智能客服、智能招聘和知识库问答。
  • 重排序 (Rerank):通过优化 Embedding 候选结果,依据话题相关性进行重排序,显著提升大型语言模型的回答质量。
  • 深度搜索 (DeepSearch):进行深度搜索与推理,直至找到最优答案,特别适用于课题研究和产品解决方案制定等复杂任务。
  • 网页搜索 (Search):输入查询词,返回搜索结果页 (SERP) 的干净正文,直接可喂给 LLM 做联网问答 / RAG。
  • 网页读取 (Reader):输入任意网址,返回该网页转换后的干净 markdown 正文,适合抓取网页内容喂给 LLM。
我们在 Jina AI 接口的基础上进行了增强,以便支持未来的功能扩展,因此在使用方式上会与官方原生调用略有不同。

快速指引

除了更换 API_KEYAIHUBMIX_API_KEY 和模型端点链接,其他参数和用法和 Jina AI 官方完全一致。 端点替换:
  • 向量嵌入 (Embeddings)https://jina.ai/embeddings -> https://aihubmix.com/v1/embeddings
  • 重排序 (Rerank)https://api.jina.ai/v1/rerank -> https://aihubmix.com/v1/rerank
  • 深度搜索 (DeepSearch)https://deepsearch.jina.ai/v1/chat/completions -> https://aihubmix.com/v1/chat/completions
  • 网页搜索 (Search)https://s.jina.ai/?q= -> https://aihubmix.com/v1/jina/search?q=
  • 网页读取 (Reader)https://r.jina.ai/<url> -> https://aihubmix.com/v1/jina/reader/<url>
    如遇当前 API 主地址不可用,可将此处域名替换为备用地址 https://api.inferera.com,路径保持不变。

一、向量嵌入 (Embeddings)

Jina AI 的 Embedding 支持普通文本和多模态图文,对于多语言任务的处理表现出众。

请求参数

string
必填
模型名称,可用的嵌入模型列表如下:
  • jina-clip-v2:多模态、多语言、1024 维、8K 上下文窗口、865M 参数
  • jina-embeddings-v3:文本模型、多语言、1024 维、8K 上下文窗口、570M 参数
  • jina-colbert-v2:多语言 ColBERT 模型,8K token 上下文,560M 参数,用于嵌入和重排序
  • jina-embeddings-v2-base-code:针对代码和文档搜索优化的模型,768 维,8K 上下文窗口,137M 参数
array
必填
输入文本或图片,根据不同模型支持不同的输入格式。对于文本,直接提供字符串数组;对于多模态模型,可以提供包含 text 或 image 字段的对象数组
string
默认值:"float"
返回的数据类型,可选值:
  • float:默认,返回浮点数数组。最常见且易于使用的格式,返回为浮点数列表
  • binary_int8:返回为 int8 打包的二进制格式。更高效的存储、搜索和传输方式
  • binary_uint8:返回为 uint8 打包的二进制格式。更高效的存储、搜索和传输方式
  • base64:返回 base64 编码的字符串。更高效的传输方式
integer
默认值:"1024"
计算维度,可选值:
  • 1024
  • 768

1. 多模态用法

2. 纯文本用法

只需要提供文本字符串数组,不需要提供 image 字段。

二、重排序 (Rerank)

重排序器的目标是提高搜索相关性和 RAG 准确性。它通过对初始搜索结果的深度分析,考虑查询与文档内容之间的细微交互,从而重新排列搜索结果,将最相关的结果放在顶部。

请求参数

string
必填
模型名称,可用模型列表如下:
  • jina-reranker-m0:多模态多语言文档重排序器,10K 上下文,2.4B 参数,用于视觉文档排序
string
必填
搜索查询文本,用于与候选文档进行比较
integer
要返回的最相关文档数量。默认返回所有文档
array
必填
候选文档数组,将根据与查询的相关性进行重新排序
integer
默认值:"4096"
文档最大分块长度,仅适用于 Cohere,不适用于 Jina。默认值为 4096。
超过该长度的长文档将自动被截断为指定的 token 数量。

1. 多模态用法

响应说明

成功的响应包含以下字段:
  • model: 使用的模型名称
  • results: 重排序结果数组,按相关性得分降序排列,每个元素包含:
    • index: 原始文档数组中的索引位置
    • relevance_score: 相关性分数,介于 0-1 之间,越高表示与查询越相关
    • total_tokens: 此请求处理的总 Token 数

2. 文本用法

文本重排序包含多语言任务和普通任务,和 embedding 用法类似,传入数组。

三、深度搜索 (DeepSearch)

DeepSearch 结合了搜索、阅读和推理能力,直到找到最佳答案。它完全兼容 OpenAI 的 Chat API 格式,只需将 api.openai.com 替换为 aihubmix.com 即可开始使用。
流式调用 (stream) 会返回思考过程。

请求参数

string
必填
模型名称,可用模型列表:
  • jina-deepsearch-v1:默认模型,搜索、阅读和推理直到找到最佳答案
boolean
默认值:"true"
是否启用流式响应。强烈建议保持此选项开启,DeepSearch 请求可能需要较长时间完成,禁用流式可能导致 ‘524 超时’ 错误
array
必填
用户与助手之间的对话消息列表。支持多种类型(模态)的消息,如文本 (.txt, .pdf)、图像 (.png, .webp, .jpeg) 等。文件大小最大支持 10MB

多模态消息格式

DeepSearch 支持多种类型的消息格式,可以包含纯文本(message)、文件(file)和图像(image)。以下是不同格式的示例:

1. 纯文本消息

2. 带有文件附件的消息

3. 带有图像的消息

所有文件和图像必须以数据 URI 格式(data URI)提前编码,最大支持 10MB。

调用示例

请注意 Jina AI 官网的 Python 流式调用会没有响应,参考我们的示例即可。

响应说明

DeepSearch 的响应默认是开启流式的,包括推理步骤和最终答案。最后一个块包含最终答案、访问的 URL 和 token 使用情况。关闭流式则不输出 thinking 内容。
注意这个对象和 Jina AI 有所差异。
Python 返回示例:
Python
基于 Jina AI 的 s.jina.ai,传入查询词即可返回搜索结果页 (SERP) 的干净正文,可直接用于 LLM 的联网问答与 RAG。接口同时支持 GETPOST
响应格式(默认 markdown):默认返回拼接好的 markdown 结果列表,直接可喂给 LLM;需要结构化数据(各结果的 title / url / contentusage 用量)时,在请求头加 Accept: application/json 即返回 JSON。

请求参数

string
必填
查询词。在代码中调用时需先做 URL 编码
integer
默认值:"5"
返回结果的条数上限;实际返回条数以可用结果数量为准
string
国家 / 地区代码,如 US
string
界面语言,如 en
string
限定在指定站点内搜索,可重复传入,如 site=jina.ai&site=github.com
string
默认值:"markdown"
结果正文格式,可选 markdown / html / text
string
图片保留策略,传 none 可移除图片以节省 token
boolean
跳过缓存,抓取最新结果
此外,搜索会对每条命中结果调用 Reader 提取正文,因此「五、网页读取 (Reader)」中用于控制正文格式的各类 X-* 请求头,同样适用于搜索结果。

调用示例

查询词与参数可作为 URL 查询参数使用 GET(推荐,最简洁),也可放入 JSON 请求体使用 POST;两者打的是同一端点、返回相同结果。下方示例默认加了 Accept: application/json 返回 JSON;去掉该头即返回干净的 markdown 结果列表(见首个 Curl-markdown 示例)。

响应说明

默认(不带 Accept)返回拼好的 markdown 列表,每条依次给出标题、来源链接、摘要(若有)与正文:
Accept: application/json 返回结构化 JSON
  • data:搜索结果数组(条数由 num 控制,上例返回 5 条,此处仅示前 2 条;content 为完整正文,示例中已截断),每条含 titleurlcontentusage.tokens
  • 计费:按各条结果的 usage.tokens 之和计费;Jina 官方对每次搜索按最低 10000 token 起收,因此最终按二者中的较大值计费,即 max(10000, token 之和)

五、网页读取 (Reader)

基于 Jina AI 的 r.jina.ai,传入任意网址即可返回该网页转换后的干净 markdown 正文,便于抓取网页内容供 LLM 使用。除网页外,还支持图片(由视觉模型生成描述)与本地文件(PDF、Word / Excel / PPT、HTML、图片)的解析。
响应格式(默认 markdown):默认直接返回干净的 markdown 正文,可直接喂给 LLM;需要带 usage 用量与 title / url 等字段的结构化 JSON(正文在 data.content)时,在请求头加 Accept: application/json

请求参数

string
必填
要读取的网页地址,直接拼接在端点路径末尾,如 /v1/jina/reader/https://jina.ai
file
上传的本地文件,支持 PDF、Word / Excel / PPT、HTML、图片,通过 POSTmultipart/form-data 放在 file 字段
string
上传 HTML 文件时必填,作为解析页面内相对链接的参考地址;上传 PDF 时无需
string
默认值:"markdown"
返回格式,可选 markdown / html / text / screenshot / pageshot
string
默认值:"all"
图片保留策略,可选 all / none(移除图片以节省 token)/ alt
链接保留策略,可选 all / none / text
boolean
为无 alt 的图片自动生成描述文字
在正文末尾汇总全部链接
boolean
在正文末尾汇总全部图片
string
抓取引擎,可选 browser / direct / cf-browser-rendering
string
CSS 选择器,仅提取匹配的页面区域
string
CSS 选择器,移除匹配的元素(如 header, footer, nav
integer
抓取超时时间(秒),最大 180
boolean
跳过缓存,抓取最新
string
默认值:"atx"
markdown 标题样式,可选 atx#)/ setext(下划线)
string
markdown 项目符号,可选 - / + / *
string
markdown 水平线样式,如 ***
markdown 链接样式,可选 inlined / referenced / discarded
以上仅为常用项。Jina 支持的全部 X-* 请求头(包括整个 X-Md-* 系列)以及 POST 请求体字段(如注入脚本 injectPageScript)均由网关原样转发,完整列表与取值请以 Jina 官方文档 为准。

多模态输入格式

Reader 支持三种输入。网页与图片直接把地址拼接在端点路径末尾(GET);本地文件通过 POSTmultipart/form-data 上传。

1. 网页 URL

2. 图片 URL(返回视觉描述)

图片地址同样拼在路径末尾。Reader 用视觉模型为图片生成描述(caption,非逐字 OCR)放入 content

3. 上传本地文件(PDF / Word·Excel·PPT / HTML / 图片)

调用示例

默认直接返回 markdown 正文;带 Accept: application/json 返回结构化 JSON。可选参数以 X-* 请求头传入,均由网关原样转发给 Jina(完整参数见上方「请求参数」)。

1. 读取网页

2. 读取图片

Curl

3. 上传本地文件

POST + multipart/form-data 上传;上传 HTML 时需额外带 url 字段作参考地址。计费方式与读取网址一致。

响应说明

默认(不带 Accept)直接返回 markdown 正文(即下方 JSON 中 data.content 的内容)。例如读取 https://example.com
Accept: application/json 则返回结构化 JSON。三类输入的 JSON 结构一致:data 为单个对象,含 title / url / content / usage.tokens。以下为三种输入的真实返回content 过长时保留开头,其余以 略去)。 ① 读取网页(读取 https://example.com):
② 读取图片content 为视觉模型生成的描述):
③ 上传本地文件(上传一篇 PDF 论文,content 较长,仅示开头):
  • status:Jina 上游返回的业务状态码,reader 成功时为 20000(与外层 HTTP 200 一致)。
  • 计费:按 data.usage.tokens(实际输出的 token 数)计费,无起步价(不同于搜索的「每次 10000 token 起收」);内容极短时按最低计费单位兜底,不会出现 0 扣费。

更新时间:2026-07-03