接口
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。整页不自动滚动加载内容。 |
| format | png(默认)或 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:无法连接截图服务。