Cloudflare Web Search API

简介

Cloudflare Web Search API 于 2026 年 10 月 2 日以公开测试版（open beta）上线，是 Cloudflare 生日周的发布之一，目的是让 AI 智能体和应用直接搜索互联网、用实时信息为回答「接地」，而不是猜 URL 或依赖模型的训练截止日期。首发接入三家搜索供应商：Ceramic.ai（默认，自建 400 亿页以上的独立索引，主打低延迟低成本，结果描述最长 8000 字符）、Exa（关键词+向量混合检索，使用 auto 模式并返回页面高亮片段）和 Linkup（fast 深度，返回带出处的原始结果）。所有供应商都承诺遵守 Cloudflare 的「已验证爬虫」要求，并在每条结果中附上来源链接；Ceramic.ai 与 Linkup 支持零数据留存（ZDR），Exa 不支持。 使用前需要一个 Cloudflare 账号、一个 AI Gateway（每个账号自带名为 default 的网关），以及已充值的 AI Gateway 额度或存放在网关上的供应商 Key。REST 调用示例：curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/websearch/ --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --header "Content-Type: application/json" --data '{"query":"...","provider":"ceramic","limit":5,"options":{"gateway":{"id":"default"}}}'，API Token 需同时具备 Workers AI 读取与 AI Gateway 读取权限。在 Worker 里则在 Wrangler 配置中添加 AI 绑定，然后调用 env.AI.websearch({ gatewayId: "default", query, provider: "exa", limit: 5 })。返回 items（url、title、description）与 metadata（query、requestId、latencyMs）；单次查询最长 1024 字符、最多 10 条结果。也可以先给模型定义一个 web_search 函数工具，模型发起调用后再执行搜索并把结果回填。官方称 AI Gateway 内置的「服务端工具」即将推出，网页搜索会是首批之一。 定价：使用 AI Gateway 额度时按各家公开 API 价计费、Cloudflare 不加价——Ceramic.ai 每千次 0.25 美元、Exa 每千次 7 美元、Linkup 每千次 5 美元；自带 Key（BYOK）则由供应商直接向你收费。来源：developers.cloudflare.com/changelog/post/2026-10-02-introducing-web-search-api/、developers.cloudflare.com/web-search/（含 how-to-use、providers）、blog.cloudflare.com/introducing-web-search-api/（2026-10-06 核对）。

• 一个 provider 参数切换 Ceramic.ai（默认）、Exa、Linkup 三家搜索源，返回格式统一
• REST 接口 POST /accounts/{account_id}/ai/websearch/，或在 Worker 中调用 env.AI.websearch()
• 返回标题、URL、描述的结构化结果，可直接塞进模型上下文
• 走 AI Gateway搜索请求与模型推理同在日志、分析与访问控制中
• 用 AI Gateway 额度按各家公开价结算、不加价，也支持自带供应商 Key（BYOK）
• 可定义 web_search 工具让模型自行调用；三家均承诺遵守 Cloudflare「已验证爬虫」规范

界面截图

可左右滑动，或使用方向键、Home 和 End 浏览截图。