专为 AI 工作流构建

AI 代理没时间修复你的环境问题

getwebp 是全球最 AI 友好的本地图像处理节点。单一二进制,零依赖,JSON 输出,在代理运行的任何地方都能工作。

GetWebP 是一款为 AI 代理工作流打造的零依赖、WASM 驱动的图像优化器。它支持 JSON 结构化输出、可从 stdin/stdout 读写,并将 PNG、JPG、GIF、TIFF 和 BMP 转换为 WebP 和 AVIF — 全部在本地完成,无需云上传、也无需 API 密钥。一条 npx 命令即可安装 AI 代理在 CI/CD 流水线、编程助手或自主工作流中处理图像所需的全部能力。

terminal — bash
$
{
"success": true,
"processed": 24,
"failed": 0,
"totalInputSize": "12.4 MB",
"totalOutputSize": "2.1 MB",
"compressionRatio": "83%",
"files": [
{
"input": "hero.jpg",
"output": "hero.webp",
"saved": "89%"
},
{
"input": "product-01.jpg",
"output": "product-01.webp",
"saved": "81%"
},
"... 22 more files"
]
}
✓ 24 files processed in 1.2s — 83% smaller

问题所在

你的图像工具正在破坏你的代理

每个依赖都是 AI 工作流的潜在故障点。

pip install 在沙盒环境中失败

Pillow 需要编译 C 扩展。沙盒代理和受限 Docker 容器无法运行。

ImageMagick 版本不匹配导致 CI 失败

v6 与 v7 API 差异,缺失委托库,系统包冲突。你的流水线在凌晨 3 点崩溃。

云 API 泄露你的数据

将图像发送到外部 API 意味着合规风险、延迟、速率限制和按图计费。

复杂配置 = 不可预测的代理行为

当环境配置不稳定时,你的代理无法区分工具故障和实际错误。

解决方案

单一二进制,完全可预测。

getwebp 从底层专为程序化使用而设计。

单一静态二进制

无运行时,无依赖,无需 pip、brew、apt-get。直接下载运行,支持 Docker FROM scratch。

已解决

结构化 JSON 输出

每次操作都返回机器可解析的 JSON。你的代理无需解析人类文本即可读取成功状态、统计数据和错误。

已解决

确定性行为

同一二进制,同一行为,处处如此。macOS、Linux、Windows、ARM、x86。你的代理完全清楚该期待什么。

已解决

AI 友好功能

专为程序化控制而设计

零依赖

无需 npm install,无需 apt-get。直接运行,无原生绑定,无系统库,无意外。

$ getwebp ./images
无需配置

JSON 输出模式

每次操作都返回结构化 JSON。解析、记录、响应。完美适配 LLM 工具调用模式。

--json 标志

标准输入/输出支持

原生支持管道。从标准输入读取,写入标准输出。与任何 Shell 命令或 AI 工具链组合使用。

管道友好

真正的批量处理

一条命令处理 1000 张图片,返回包含每个文件结果的 JSON 数组。无需循环。

1000 文件,1 条命令

可预测的退出码

0 = 成功,非零 = 失败。代理无需解析输出即可立即判断结果。

代理可读

跨平台二进制

同一二进制在 macOS、Linux、Windows、ARM、x86 上行为一致。CI 与本地永远匹配。

通用

代码示例

集成到任何工作流

#!/bin/bash
# Process images and parse JSON output
RESULT=$(getwebp ./images/*.jpg --json)
if [ $? -eq 0 ]; then
SAVED=$(echo $RESULT | jq -r '.compressionRatio')
COUNT=$(echo $RESULT | jq -r '.processed')
echo "✓ Processed $COUNT files, saved $SAVED"
else
echo "✗ Error: $(echo $RESULT | jq -r '.error')"
exit 1
fi
JSON 输出

默认机器可读

传入 --json 时,每次操作都返回代理可推理的结构化数据。

选择操作:
Input Command
Exit code: 0
$getwebp hero.jpg --json
JSON Output
{
  "success": true,
  "operation": "convert",
  "input": {
    "file": "hero.jpg",
    "size": "1.2 MB",
    "format": "JPEG"
  },
  "output": {
    "file": "hero.webp",
    "size": "142 KB",
    "format": "WebP"
  },
  "saved": "88%",
  "duration": "0.3s"
}
生态系统

与 AI 技术栈无缝协作

无需自定义适配器。只要能运行 Shell 命令,就能与 getwebp 配合使用。

Claude CodeAI Coding
GitHub ActionsCI/CD
DockerContainers
n8nAutomation
PythonScripting
Bash / ShellShell

Works with any tool that can run a shell command

为何选择 getwebp

AI 友好的最佳选择

与其他程序化工作流图像处理工具的比较。

FeaturesgetwebpBest for AIImageMagickPillowCloudinary APIsharp (Node)
零依赖
JSON 输出
100% 离线/本地
单一二进制
可预测退出码
批量 JSON 数组输出
跨平台一致
AI 代理就绪
真实工作流

AI 团队如何使用 getwebp

LLM 图像预处理流水线

在将图像发送到视觉模型之前,调整大小并压缩以降低高达 80% 的 token 成本。getwebp 用一条返回 JSON 的命令处理整批图像。

Workflow

User Inputimage path
getwebpresize + compress
Vision APIGPT-4V / Claude
Resultparsed JSON

Example

python
# Reduce image size before sending to GPT-4V
result = subprocess.run([
    "getwebp", image_path,
    "--resize", "1024x1024",
    "--json"
], capture_output=True, text=True)
data = json.loads(result.stdout)
# Tokens saved: ~80% for typical product photos

常见问题

AI 开发者的常见问题

你的代理在等待。

停止与依赖抗争。

一条命令,零配置,JSON 输出。你的 AI 技术栈一直缺少的图像工具。

npx getwebp@latest --help

No signup. No credit card. Works offline.