我构建了一个无状态图像处理 API —— 它是如何工作的

Source: Dev.to

请提供您希望翻译的完整文本（包括标题、段落、代码块说明等），我将按照要求保留源链接并将内容翻译成简体中文。谢谢！

问题

图像处理基础设施出乎意料地复杂：

• 在不同操作系统目标上安装本机依赖
• 管理临时文件和磁盘清理
• 处理格式怪癖（AVIF 支持、GIF 动画、颜色配置文件）
• 用于背景移除等 AI 操作的 GPU 加速
• 在负载下扩展而不泄漏内存

我想要一个 API，你发送一张图像进去，得到处理后的图像返回。没有存储，没有磁盘缓存，请求之间没有状态。

工作原理

TheGlitch 完全在内存中处理图像。流水线如下：

Input (URL/base64/binary/form) 
  → Decode & Validate 
  → Resize & Crop 
  → Apply Effects 
  → Format Convert 
  → Return Binary

单个 GET 请求即可完成所有操作：

curl "https://theglitch.p.rapidapi.com/api/v1/process?\
url=https://picsum.photos/1000&\
width=800&\
format=webp&\
brightness=10&\
contrast=15&\
sharpen=20" \
  -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: theglitch.p.rapidapi.com" \
  -o result.webp

功能

• Resize & Crop – 四种模式：fit（保持纵横比），fill（裁剪至精确尺寸），pad（添加边框），stretch。支持最高 8000 × 8000 像素的分辨率。
• Format Conversion – 输入/输出：JPEG、PNG、WebP、GIF、BMP、TIFF。可针对每种格式进行质量控制。
• 7 Visual Effects – 亮度、对比度、饱和度、模糊、锐化、灰度、棕褐色。所有效果可在一次请求中组合使用。
• AI Background Removal – GPU 加速，约 3 秒/张。返回透明 PNG。
• 14 Social Media Presets – Instagram 方形、Facebook 封面、YouTube 缩略图、LinkedIn 横幅等。只需一个参数，无需记忆尺寸。

代码示例

JavaScript

const response = await fetch(
  'https://theglitch.p.rapidapi.com/api/v1/process?url=IMAGE_URL&width=800&format=webp',
  {
    headers: {
      'X-RapidAPI-Key': 'YOUR_KEY',
      'X-RapidAPI-Host': 'theglitch.p.rapidapi.com'
    }
  }
);
const blob = await response.blob();

Python

import requests

response = requests.get(
    'https://theglitch.p.rapidapi.com/api/v1/process',
    params={'url': 'IMAGE_URL', 'width': 800, 'format': 'webp'},
    headers={'X-RapidAPI-Key': 'YOUR_KEY', 'X-RapidAPI-Host': 'theglitch.p.rapidapi.com'}
)

with open('result.webp', 'wb') as f:
    f.write(response.content)

为什么是无状态的？

• GDPR 设计合规 – 永不存储用户数据
• 无磁盘 I/O 瓶颈 – 所有操作都在 RAM 中进行
• 可预测的扩展 – 每个请求相互独立
• 无需清理作业 – 没有需要垃圾回收的内容

架构决策

• SkiaSharp over ImageMagick – 本地性能，跨平台，无外部依赖。权衡：格式支持较少（尚未支持 AVIF 编码），但 WebP 能覆盖大多数使用场景。
• Replicate for GPU ops – 通过 Replicate 代理 AI 操作。使用 BiRefNet 进行背景移除的成本约为每张图片 $0.0014；公共模型的冷启动免费。
• Separate CPU and GPU rate limits – CPU 操作（调整大小、特效、格式转换）成本低；GPU 操作（背景移除）成本高。不同计划设置不同限制，使定价更公平。
• Single VPS deployment – 使用 Docker Compose，Caddy 作为反向代理，前置 Cloudflare 提供 CDN/DDoS/SSL。整体基础设施费用低于每月 $6。

API 端点

试用

API 已上线，提供免费套餐（每月 500 次请求）。请查看网站上的前后对比示例，或直接通过 RapidAPI 试用：

• 带实时示例的网站：
• RapidAPI 上的 API：

我很想了解您觉得哪些功能有用。背景移除是 beta 期间需求最高的功能——接下来您希望我们提供什么？