Amux AI

Web Fetch

最近更新:2026年11月22日

统一网页抓取与正文提取端点,将目标 URL 转换为适配大模型的干净 Markdown 或结构化内容。

统一的同步网页抓取与正文提取端点,按 model 字段路由至对应抓取引擎(当前支持 Jina Fetch 与 DeepSeek Fetch),输出清洗后的 Markdown 文本、元信息及计费用量。

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://,禁止内嵌账密凭据)。

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
  }
}