Amux AI

Jina Fetch

最近更新:2026年11月22日

Jina AI 网页抓取与正文提取(jina/jina-fetch)的规格参数、抓取引擎选项与调用示例。

Jina Fetch(上游 https://r.jina.ai/)可将任意公开网页或文档 URL 转换为干净的 Markdown / 纯文本 / HTML,并支持无头浏览器渲染、CSS 选择器过滤、页面截图以及 readerlm-v2 与 jina-ocr-v1 增强解析模式。

该工具通过 Web Fetch(POST /v1/tools/fetch)端点调用,使用 Authorization: Bearer <key> 鉴权。

工具规格

属性说明
模型 IDjina/jina-fetch
可用别名jina-fetch、jina-ai/jina-fetch
支持引擎direct、browser、cf-browser-rendering、readerlm-v2
输出形态markdown、html、text、screenshot、pageshot、readerlm-v2、jina-ocr-v1
计费方式按 Jina 实际折算后的 usage.total_tokens(即 scaled_tokens)计费;实时单价见模型详情页
流式输出不支持
POSThttps://gateway.amux.ai/v1/tools/fetch

鉴权

header
Authorizationstring必填

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

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

固定为 application/json。

请求

application/json
modelstring必填

模型标识,支持规范 ID jina/jina-fetch 或裸名别名 jina-fetch。

urlstring必填

目标网页 URL(仅支持 http:// 与 https://,禁止内嵌账密凭据)。

engine"direct" | "browser" | "cf-browser-rendering" | "readerlm-v2"

抓取引擎(映射为 X-Engine):direct 极速直抓、browser 无头浏览器渲染、cf-browser-rendering 或 readerlm-v2。

respond_with"markdown" | "html" | "text" | "screenshot" | "pageshot" | "readerlm-v2" | "jina-ocr-v1"

输出形态(映射为 X-Respond-With)。readerlm-v2、screenshot 与 jina-ocr-v1 由 Jina 自动在 usage.scaled_tokens 中折算计费 token。

token_budgetinteger

最大输出 token 预算(映射为 X-Token-Budget)。

target_selectorstring

CSS 选择器,仅抓取指定 DOM 节点(映射为 X-Target-Selector)。

wait_for_selectorstring

CSS 选择器,等待动态元素加载后再提取(映射为 X-Wait-For-Selector)。

remove_selectorstring

CSS 选择器,提取前移除指定节点(映射为 X-Remove-Selector)。

no_cacheboolean默认 false

设为 true 时附加 X-No-Cache: true 绕过缓存。

with_links_summaryboolean默认 false

是否在响应中附带页面链接汇总(映射为 X-With-Links-Summary)。

with_images_summaryboolean默认 false

是否在响应中附带图片汇总(映射为 X-With-Images-Summary)。

响应

200response

网页抓取成功。

400response

请求参数或 URL 不合法。

402response

工作区可用余额不足。

使用说明

  • 常规抓取按提取正文的 token 数结算;当指定 respond_with: "readerlm-v2"、"screenshot" 或 "jina-ocr-v1" 时,Jina 会在响应 usage.scaled_tokens(及 usage.total_tokens)中返回折算倍率/保底后的最终计费 token 数,平台严格按该数值结算。
  • 动态单页应用(SPA)建议搭配 engine: "browser" 与 wait_for_selector 使用;静态文档页可用 engine: "direct" 降低延迟。

错误处理

错误响应采用 OpenAI 标准结构。非法 URL、非 http(s) 协议或内嵌凭据 URL 均返回 400 invalid_request;完整错误码见错误与重试。

cURL
curl https://gateway.amux.ai/v1/tools/fetch \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jina/jina-fetch",
    "url": "https://example.com"
  }'
{
  "object": "page",
  "model": "jina/jina-fetch",
  "url": "https://example.com/",
  "title": "Example Domain",
  "content": "# Example Domain",
  "usage": {
    "total_tokens": 341,
    "measured_tokens": 341,
    "scaled_tokens": 341
  }
}