Jina Search
最近更新:2026年11月22日
Jina AI 联网搜索(jina/jina-search)的规格参数、结果结构与调用示例。
Jina Search(上游 https://s.jina.ai/)可将自然语言搜索词转化为面向大模型的结构化搜索结果列表,并可选同步抓取结果页面的干净 Markdown 正文。
该工具通过 Web Search(POST /v1/tools/search)端点调用,使用 Authorization: Bearer <key> 鉴权。
工具规格
| 属性 | 说明 |
|---|---|
| 模型 ID | jina/jina-search |
| 可用别名 | jina-search、jina-ai/jina-search |
| 支持能力 | 实时联网搜索、站点域名过滤(site)、地区/语言定位(country / language)、可选网页正文提取 |
| 计费方式 | 按 Jina 实际返回的 usage.total_tokens 计费(单次搜索含官方 10,000 token 最低保底);实时单价见模型详情页 |
| 流式输出 | 不支持 |
POST
https://gateway.amux.ai/v1/tools/search鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填模型标识,支持规范 ID jina/jina-search 或裸名别名 jina-search。
querystring必填搜索关键词(同时兼容别名 q)。
countinteger期望返回的搜索结果数量(1–50,映射至上游 num)。
need_contentboolean默认 true是否抓取各条结果正文;设为 false 时自动向 Jina 传递 X-Respond-With: no-content 仅返回标题、URL 与摘要。
sitestring | array<string>限定搜索的目标站点域名(映射为 X-Site)。
countrystring搜索地区代码(映射为 gl,如 US)。
languagestring搜索语言代码(映射为 hl,如 en)。
no_cacheboolean默认 false设为 true 时附加 X-No-Cache: true 跳过缓存。
token_budgetinteger限制返回正文最大 token 预算(映射为 X-Token-Budget)。
响应
200response搜索成功。
400response请求参数不合法。
402response工作区可用余额不足。
使用说明
- 仅需检索标题、链接与摘要片段时,可传入
need_content: false以显著缩短耗时(网关自动向上游传递X-Respond-With: no-content)。 - 若需对搜索结果中的指定网页执行深度定制抓取(如 CSS 选择器、无头浏览器或
readerlm-v2),可搭配 Jina Fetch 使用。
错误处理
错误响应采用 OpenAI 标准结构。缺少 query 或 count 超出 1–50 范围返回 400 invalid_request;完整错误码见错误与重试。
cURL
curl https://gateway.amux.ai/v1/tools/search \
-H "Authorization: Bearer $AMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jina/jina-search",
"query": "Jina Embeddings v5 overview",
"count": 3,
"need_content": false
}'{
"object": "list",
"model": "jina/jina-search",
"results": [
{
"title": "Jina Embeddings v5",
"url": "https://jina.ai/news/jina-embeddings-v5",
"snippet": "Multilingual dense and multimodal embedding models.",
"content": "# Jina Embeddings v5"
}
],
"usage": {
"total_tokens": 10000
}
}