截作开发者门户

截作是开源的浏览器截图编辑器，并提供一组小型公开 HTTP API。本页是对接入口：接口无需鉴权，契约以 OpenAPI 3.1 发布，整个应用在 GitHub 上以 Apache 2.0 开源。

从这里开始

API 文档

每个公开接口的请求与响应示例，以及错误码表。

OpenAPI 3.1 规范

含 operationId、带类型参数和响应结构的机器可读契约。

鉴权与速率限制

无需 API 密钥。每 IP 限制和 429 语义。

llms.txt

面向 AI 智能体和 LLM 爬虫的 Markdown 站点概览。

llms-full.txt

覆盖功能和 API 的长篇 Markdown 参考。

GitHub 上的源代码

Apache 2.0。Issue、讨论和自行部署说明。

API 密钥

没有密钥，也没有要注册的东西。公开 API 是匿名的，由每 IP 速率限制约束，而不是凭据。详情见鉴权与速率限制。

快速开始

1. 截取实时页面

没有密钥，无需注册。提交一个 URL，读回 base64 PNG。

curl -s -X POST https://kimte.com/api/screenshot \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","deviceType":"desktop"}' \
  | jq -r .screenshot | base64 -d > shot.png

2. 优化导出

把图片再送回 Sharp，重新压缩为 WebP。

curl -s -X POST https://kimte.com/api/export \
  -F "image=@shot.png" \
  -F "format=webp" \
  -F "qualityPreset=high" \
  -o shot.webp

3. 处理失败

每次失败请求都返回同一套 JSON 信封。根据 code 分支。

{
  "error": "URL is required",
  "code": "invalid_request",
  "message": "URL is required",
  "hint": "Send a JSON body with a \"url\" string.",
  "status": 400,
  "documentation": "https://kimte.com/docs#errors"
}

沙箱

没有单独的沙箱主机。对着生产环境试验是安全的：这些接口对你的数据是只读的，不会按账号存储任何内容，编辑器本身也不会上传你的图片。若要在本地跑完整栈：

git clone https://kimte.com/contact.git
cd screenshot-studio
npm install
npm run dev

构建智能体

直接把 /openapi.json 作为函数调用工具定义加载。每个操作都有唯一的 operationId、描述、带类型的参数和响应结构。本站任意页面也可按请求提供 Markdown：

curl -H "Accept: text/markdown" https://kimte.com/docs

CLI 与 MCP 服务器

目前还没有正式的 CLI 工具或 MCP 服务器。上面的 curl 示例就是受支持的命令行路径。如果你需要其中任意一个，提交 issue。

支持

在 GitHub issues提交缺陷和功能请求，或通过联系页面联系维护者。