Amux AI

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> 鉴权。

工具规格

属性说明
模型 IDjina/jina-search
可用别名jina-search、jina-ai/jina-search
支持能力实时联网搜索、站点域名过滤(site)、地区/语言定位(country / language)、可选网页正文提取
计费方式按 Jina 实际返回的 usage.total_tokens 计费(单次搜索含官方 10,000 token 最低保底);实时单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/tools/search

鉴权

header
Authorizationstring必填

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

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

固定为 application/json。

请求

application/json
modelstring必填

模型标识,支持规范 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
  }
}