Web Fetch
最近更新:2026年11月22日
统一网页抓取与正文提取端点,将目标 URL 转换为适配大模型的干净 Markdown 或结构化内容。
统一的同步网页抓取与正文提取端点,按 model 字段路由至对应抓取引擎(当前支持 Jina Fetch 与 DeepSeek Fetch),输出清洗后的 Markdown 文本、元信息及计费用量。
POST
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://,禁止内嵌账密凭据)。
enginestring可选的抓取引擎(如 Jina 支持 direct、browser、cf-browser-rendering、readerlm-v2)。
respond_withstring可选的响应内容形态(如 markdown、html、text、screenshot、readerlm-v2、jina-ocr-v1)。
token_budgetinteger可选的输出 token 上限预算。
target_selectorstring可选的 CSS 选择器,仅提取匹配区域。
wait_for_selectorstring可选的 CSS 选择器,等待动态渲染元素出现后再提取。
remove_selectorstring可选的 CSS 选择器,提取前剔除指定区域。
no_cacheboolean默认 false是否绕过上游缓存实时抓取。
响应
200response网页抓取成功。
400response请求体或 URL 不合法,或目标模型不支持抓取端点。
402response工作区账户余额不足。
协议特性说明
- 安全 URL 校验:仅接受合法的
http://与https://URL,拒绝内嵌账密凭据(user:pass@host)或非 HTTP 协议。 - 高阶能力白名单翻译:支持通过 JSON 字段控制抓取引擎(
engine)、输出形态(respond_with)、CSS 选择器与缓存开关,由网关安全转换为对应上游参数。 - 同步非流式:不支持
stream: true;单次响应体上限 24 MB。
错误处理
错误响应统一采用 OpenAI 标准错误结构。非法 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",
"description": "<string>",
"content": "# Example Domain",
"usage": {
"total_tokens": 341,
"measured_tokens": 341,
"scaled_tokens": 341
}
}