跳轉到主要內容

說明

我們整合了 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 支援多模態圖文,對於多語言任務的處理表現出眾。

請求參數

model
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 參數
input
array
必填
輸入文本或圖片,根據不同模型支援不同的輸入格式。對於文本,直接提供字串陣列;對於多模態模型,可以提供包含 text 或 image 字段的物件陣列
embedding_format
string
預設值:"float"
返回的資料類型,可選值:
  • float:預設,返回浮點數陣列。最常見且易於使用的格式,返回為浮點數列表
  • binary_int8:返回為 int8 打包的二進位格式。更高效的儲存、搜尋和傳輸方式
  • binary_uint8:返回為 uint8 打包的二進位格式。更高效的儲存、搜尋和傳輸方式
  • base64:返回 base64 編碼的字串。更高效的傳輸方式
dimensions
integer
預設值:"1024"
計算維度,可選值:
  • 1024
  • 768

1. 多模態用法

2. 純文本用法

只需要提供文本字串陣列,不需要提供 image 字段。

二、重排序 (Rerank)

重排序器的目標是提高搜尋相關性和 RAG 準確性。它透過對初始搜尋結果的深度分析,考慮查詢與文件內容之間的細微互動,從而重新排列搜尋結果,將最相關的結果放在頂部。

請求參數

model
string
必填
模型名稱,可用模型列表如下:
  • jina-reranker-m0:多模態多語言文件重排序器,10K 上下文,2.4B 參數,用於視覺文件排序
query
string
必填
搜尋查詢文本,用於與候選文件進行比較
top_n
integer
要返回的最相關文件數量。預設返回所有文件
documents
array
必填
候選文件陣列,將根據與查詢的相關性進行重新排序
max_chunk_per_doc
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) 會返回思考過程。

請求參數

model
string
必填
模型名稱,可用模型列表:
  • jina-deepsearch-v1:預設模型,搜索、閱讀和推理直到找到最佳答案
stream
boolean
預設值:"true"
是否啟用流式回應。強烈建議保持此選項開啟,DeepSearch 請求可能需要較長時間完成,禁用流式可能导致 ‘524 超時’ 錯誤
messages
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。

請求參數

q
string
必填
查詢詞。在程式碼中呼叫時需先做 URL 編碼
num
integer
預設值:"5"
回傳結果的條數上限;實際回傳條數以可用結果數量為準
gl
string
國家 / 地區代碼,如 US
hl
string
介面語言,如 en
site
string
限定在指定站台內搜尋,可重複傳入,如 site=jina.ai&site=github.com
X-Respond-With
string
預設值:"markdown"
結果正文格式,可選 markdown / html / text
X-Retain-Images
string
圖片保留策略,傳 none 可移除圖片以節省 token
X-No-Cache
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
file
上傳的本機檔案,支援 PDF、Word / Excel / PPT、HTML、圖片,透過 POSTmultipart/form-data 放在 file 欄位
url
string
上傳 HTML 檔案時必填,作為解析頁面內相對連結的參考位址;上傳 PDF 時無需
X-Respond-With
string
預設值:"markdown"
回傳格式,可選 markdown / html / text / screenshot / pageshot
X-Retain-Images
string
預設值:"all"
圖片保留策略,可選 all / none(移除圖片以節省 token)/ alt
連結保留策略,可選 all / none / text
X-With-Generated-Alt
boolean
為無 alt 的圖片自動生成描述文字
在正文末尾彙總全部連結
X-With-Images-Summary
boolean
在正文末尾彙總全部圖片
X-Engine
string
抓取引擎,可選 browser / direct / cf-browser-rendering
X-Target-Selector
string
CSS 選擇器,僅提取匹配的頁面區域
X-Remove-Selector
string
CSS 選擇器,移除匹配的元素(如 header, footer, nav
X-Timeout
integer
抓取逾時時間(秒),最大 180
X-No-Cache
boolean
跳過快取,抓取最新
X-Md-Heading-Style
string
預設值:"atx"
markdown 標題樣式,可選 atx#)/ setext(底線)
X-Md-Bullet-List-Marker
string
markdown 項目符號,可選 - / + / *
X-Md-Hr
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