跳转到主要内容

网页截图 API

每成功生成一张截图消耗 1 积分,首屏和整页同价,失败不扣费。

接口

POST https://api.404wl.com/v1/url2img

使用 Bearer API Key,内容类型为 application/json。数字和布尔值必须使用 JSON 原生类型,不接受未知参数。

参数说明
url必填,最长 8192 字符;无登录凭据的公网 HTTP/HTTPS 地址。
width / height整数,1–16384,默认 1280 / 720。
full_page布尔值,默认 false。整页不自动滚动加载内容。
formatpng(默认)或 jpeg。
quality整数,1–100,默认 90,仅 JPEG 生效。
wait_ms加载后等待毫秒数,整数,0–5000,默认 1000。

默认输出上限:2000 万像素、单边 16384 像素、编码前图片 10 MiB;后端处理预算 30 秒。不提供登录态或自定义脚本。

同一用户所有密钥共享每分钟 10 次额度,与其他产品独立计数。

调用示例

curl 'https://api.404wl.com/v1/url2img' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com","format":"jpeg","full_page":true}'

成功响应

{"success":true,"request_id":"provider-request-id","data":{"format":"jpeg","width":1280,"height":720,"image_base64":"..."},"error":null}

错误码

鉴权、积分不足和限流见共用文档。

  • 403 URL_FORBIDDEN:禁止访问非公网地址或含凭据的 URL。
  • 413 OUTPUT_TOO_LARGE:视口或输出超过限制。
  • 422 INVALID_REQUEST:参数无效。
  • 502 TARGET_UNAVAILABLE:目标解析、访问或加载失败。
  • 503 BUSY / RENDER_NOT_READY:截图服务繁忙或浏览器未就绪。
  • 504 RENDER_TIMEOUT:截图处理超时。
  • 502 PROVIDER_ERROR / INVALID_PROVIDER_RESPONSE:服务响应异常。
  • 503 PROVIDER_UNAVAILABLE:无法连接截图服务。