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> 鉴权。
工具规格
| 属性 | 说明 |
|---|---|
| 模型 ID | jina/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)计费;实时单价见模型详情页 |
| 流式输出 | 不支持 |
https://gateway.amux.ai/v1/tools/fetch鉴权
headerAuthorizationstring必填Bearer <你的 Amux AI 密钥> 在控制台创建的 Amux AI API 密钥。
Content-Typestring必填默认 "application/json"固定为 application/json。
请求
application/jsonmodelstring必填模型标识,支持规范 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_selectorstringCSS 选择器,仅抓取指定 DOM 节点(映射为 X-Target-Selector)。
wait_for_selectorstringCSS 选择器,等待动态元素加载后再提取(映射为 X-Wait-For-Selector)。
remove_selectorstringCSS 选择器,提取前移除指定节点(映射为 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 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
}
}