SnapService — 截图即服务

免费截图 API，地址为 https://snap.llm.kaveenk.com。 向该地址 POST 一个 URL，即可返回 PNG 或 JPEG 格式的截图。底层由无头 Chromium 驱动。

快速开始（2 步）

步骤 1：注册 API 密钥

curl -s -X POST https://snap.llm.kaveenk.com/api/register 
  -H "Content-Type: application/json" 
  -d '{"name":"my-agent"}'

响应示例：

{"key":"snap_abc123...","name":"my-agent","limits":{"per_minute":2,"per_day":200}}

重要提示：请安全存储 key 字段值，该密钥无法找回。

每个 IP 地址仅允许注册一个 API 密钥。

步骤 2：截取网页截图

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot 
  -H "Authorization: Bearer snap_yourkey" 
  -H "Content-Type: application/json" 
  -d '{"url":"https://example.com"}' 
  -o screenshot.png

完成！仅需两步。

截图选项

所有选项均以 JSON 字段形式与 url 一同置于 POST 请求体中：

速率限制

• 每密钥每分钟最多 2 张截图
• 每密钥每天最多 200 张截图
• 每个 IP 地址仅限 1 个 API 密钥
• 最大页面高度：16384 像素（仅在 full_page=true 模式下生效）
• 单张截图最大尺寸：10 MB

响应状态码

• 200：返回 PNG 或 JPEG 图像二进制数据
• 400：请求无效（缺少 URL 或参数格式错误）
• 401：API 密钥缺失或无效
• 409：IP 地址已存在 API 密钥（注册时返回）
• 429：超出速率限制
• 500：服务器内部错误

含全部选项的调用示例

curl -s -X POST https://snap.llm.kaveenk.com/api/screenshot 
  -H "Authorization: Bearer snap_yourkey" 
  -H "Content-Type: application/json" 
  -d '{
    "url": "https://example.com",
    "format": "jpeg",
    "full_page": true,
    "width": 1920,
    "height": 1080,
    "dark_mode": true,
    "wait_ms": 2000,
    "block_ads": true
  }' 
  -o screenshot.jpg

Python 示例

import requests

API = "https://snap.llm.kaveenk.com"

# 注册（仅需一次）
r = requests.post(f"{API}/api/register", json={"name": "my-agent"})
key = r.json()["key"]

# 截图
r = requests.post(f"{API}/api/screenshot",
    headers={"Authorization": f"Bearer {key}"},
    json={"url": "https://example.com", "full_page": True})
with open("shot.png", "wb") as f:
    f.write(r.content)