截取完整页面、指定视口或页面元素的网页截图 API
把公开网页转换成 PNG、JPEG 或 WebP，并明确控制截图范围、视口、页面就绪条件和颜色模式。
接口
把公开网页转换成图片，并明确控制输出格式、视口、页面状态和截图范围。
从页面顶部一直截取到底部。
通过 CSS 选择器截取一个可见元素。
设置视口、DPR、等待条件和颜色模式。
适合用于
网站预览 / 视觉测试素材 / Agent 视觉输入
截取工作流真正需要的页面状态
Screenshot endpoint 接收一个公开的 HTTP 或 HTTPS URL，直接返回图片响应。你可以选择完整页面或指定元素截图，设置视口尺寸和 DPR，并等待页面加载或指定元素可见后再截图。
完整页面或指定元素
截取整个文档，或通过 CSS 选择器截取一个可见元素。
响应式渲染
设置视口宽高和 1–2× 设备像素比。
页面就绪控制
等待 load、network idle、指定元素可见或增加延迟。
图片输出控制
选择 PNG、JPEG、WebP、质量、浅色或深色、背景和动画行为。
什么是网页截图 API？
网页截图 API 会在托管浏览器中打开网页并返回渲染后的图片，让应用无需维护自己的 Chromium 集群也能截取动态页面。Search1API 支持 PNG、JPEG、WebP，完整页面或 CSS 选择器截图，视口与 DPR、页面等待、超时、颜色模式、背景和动画控制。
典型流程
把公开网页转换成 PNG、JPEG 或 WebP，并明确控制截图范围、视口、页面就绪条件和颜色模式。
发送一个公开 URL，并设置输出格式和截图参数。
服务在托管浏览器中渲染网页，并等待指定的页面状态。
接收图片二进制响应，再由应用负责比较、存储或分析。
适合场景
将公开网页转换为 PNG、JPEG 或 WebP 图片
根据 URL 生成网站缩略图和链接预览。
为独立的视觉比较系统生成基准图和待比较图片。
为下游视觉模型或 agent 准备网页图片。
常见问题
网页截图 API 支持哪些图片格式？
支持 PNG、JPEG 和 WebP。JPEG 与 WebP 可以设置 1–100 的 quality。
可以只截取一个页面元素吗？
可以。传入 CSS 选择器即可截取一个可见元素。指定元素截图与完整页面截图不能同时开启。
如何等待网页加载完成？
可以等待 DOM、load 或 network idle，也可以等待指定 CSS 选择器可见，或增加最多 5 秒延迟。请求超时可设置为 1–30 秒。
网页截图 API 消耗多少积分？
成功的网页截图 API 请求消耗 2 积分，失败请求不扣费。