微信扫码登录
用微信小程序扫码,自动注册(新用户送 100 次免费额度 + 5 次试用调试),仅支持微信登录。
在线调试 需登录NEW
未登录快速开始
注册后在控制台复制 API Key,替换下面的 kt_xxx;也可先用顶部「调试」页试效果(需登录,送 5 次试用调试)。
# 网页截图(PNG,整页)
curl -X POST https://api.largetech.top/v1/screenshot \
-H "Authorization: Bearer kt_xxx" -H "Content-Type: application/json" \
-d '{"url":"https://example.com","width":1280,"fullPage":true}' -o shot.png
# 网页转 PDF(A4 + 水印)
curl -X POST https://api.largetech.top/v1/pdf \
-H "Authorization: Bearer kt_xxx" -H "Content-Type: application/json" \
-d '{"url":"https://example.com","format":"A4","watermark":"仅供内部预览"}' -o page.pdf
# 网页转 Markdown(喂 AI / 大模型)
curl -X POST https://api.largetech.top/v1/markdown \
-H "Authorization: Bearer kt_xxx" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/article"}'
# 结构化提取(标题/描述/正文/图片/链接)
curl -X POST https://api.largetech.top/v1/extract \
-H "Authorization: Bearer kt_xxx" -H "Content-Type: application/json" \
-d '{"url":"https://example.com/article"}'
接口一览 NEW:extract / batch / monitor / mcp
| 端点 | 参数 | 说明 |
|---|---|---|
/v1/screenshot | url*, width, height, fullPage, format(png|jpeg), quality, waitFor, deviceScaleFactor, mobile, userAgent, waitUntil(load|domcontentloaded|networkidle2), watermark | 返回图片二进制 |
/v1/pdf | url*, format(A4|letter), landscape, scale, margin{top,bottom,left,right}, headerText, footerText, watermark, waitFor, waitUntil | 返回 PDF 二进制 |
/v1/markdown | url*, waitFor | 返回 JSON:title + markdown(链接已绝对化) |
/v1/extract | url*, waitFor | 结构化 JSON:title/description/ogImage/canonical/text/images/links/headings |
/v1/batch | endpoint(screenshot|pdf|markdown|extract), urls[](≤50), opts{} | 一次提交多个 URL,按成功次数扣费,返回结果数组 |
/v1/monitor | url*, name, intervalMin(≥5), webhook(可选) | 定时抓取页面,内容变化时记录并推送到 webhook(企业微信机器人可直接用) |
/v1/monitors / /v1/monitor/logs / /v1/monitor/delete | id | 监控任务列表 / 历史记录 / 删除(每账号最多 3 个) |
/v1/debug | endpoint, url, opts{}(需登录带 Key) | 在线调试:扣独立试用额度(新用户 5 次),用尽自动切余额正式调用 |
/v1/usage | - | 查询余额与用量 |
/mcp | JSON-RPC 2.0:initialize / tools/list / tools/call | MCP 接入点(截图/PDF/Markdown/结构化四个工具),AI 客户端可直接配置 |
* 必填;仅支持公网 http/https 地址。渲染成功扣 1 次,失败不扣费(响应带 noCharge 与剩余余额)。
MCP 接入(AI 工具)
在支持 MCP 的客户端(Claude Desktop / Cursor / 各类 Agent)中配置:
{
"mcpServers": {
"largetech-render": {
"url": "https://api.largetech.top/mcp",
"headers": { "Authorization": "Bearer kt_xxx" }
}
}
}
可用工具:screenshot(返回图片)、pdf、markdown、extract。每次调用扣 1 次余额。
限流规则(压测校准后)
单机串行渲染吞吐实测 ≈150 次/分钟,为保证稳定按以下档位限流:
| 维度 | 限流 | 说明 |
|---|---|---|
| 每 API Key | 20 次/分钟 | 开发者订阅 60 次/分、企业订阅 120 次/分(订阅上线后自动生效) |
| 每 IP | 60 次/分钟 | 防单 IP 刷爆(低于系统真实吞吐) |
| 调试接口 | 每 Key 30 次/分钟 | 另扣独立试用额度,不占余额 |
| 渲染执行 | 串行队列 | 同一时刻只渲染 1 个页面,超长队列由 45s 超时兜底 |
错误码
| 状态码 | error | 含义 |
|---|---|---|
| 400 | invalid-url / bad-endpoint | URL 不合法或参数错误 |
| 401 | missing-api-key / invalid-api-key / login-required | 未带 Key / Key 无效 / 调试未登录 |
| 402 | insufficient-balance / trial-exhausted | 余额不足 / 试用调试额度用完 |
| 422 | render-failed / render-timeout | 渲染失败或超时(不扣费,响应带 noCharge 与剩余余额) |
| 429 | rate-limit / debug-rate-limit | 触发频率限流(见上表) |