Cutout.Pro Visual API — 图像处理工具包

概述

通过 Cutout.Pro REST API 访问三项核心图像处理能力：

1. 背景移除器（Background Remover） — 自动识别前景、移除背景，并返回带透明通道的 PNG 图像
2. 人像抠图（Face Cutout） — 精确分割人脸及发丝区域，支持 68 点面部关键点检测
3. 照片增强器（Photo Enhancer） — 基于 AI 的超分辨率增强技术，可将模糊、低质量的照片提升为高清图像

适用场景

• 用户需要移除图像背景时
• 用户需要提取人脸或头像区域时
• 用户需要提升照片清晰度或分辨率时
• 用户提及“背景移除”、“抠图”、“人像分割”等相关关键词时
• 用户提及“图像增强”、“超分辨率”、“照片修复”等相关关键词时

不适用场景

• 任务与图像处理无关时
• 用户需要生成新图像（而非处理已有图像）时
• 用户需要处理视频（请使用其他工具）时

工作原理

图像由 Cutout.Pro API 基于 AI 进行处理。每次调用消耗积分（标准模式：1 积分/张图；预览模式：0.25 积分/张图）。

API 对比

快速开始

1. 访问 https://www.cutout.pro/user/secret-key 获取您的 API Key
2. 将其添加至 .env 文件中：CUTOUT_API_KEY=your_key_here
3. 安装依赖项：pip install -r scripts/requirements.txt
4. 运行脚本：python scripts/cutout.py --api bg-remover --image photo.jpg

完整配置说明请参阅 references/setup-guide.md。

1. 运行模式

2. 使用示例

# 背景移除 — 上传本地文件，保存为 PNG
python scripts/cutout.py --api bg-remover --image product.jpg --output out.png

# 背景移除 — 传入图像 URL，返回 Base64 编码结果
python scripts/cutout.py --api bg-remover --url "https://example.com/photo.jpg"

# 背景移除 — 自动裁剪留白并添加白色背景
python scripts/cutout.py --api bg-remover --image photo.jpg --crop --bgcolor FFFFFF

# 人像抠图 — 上传本地文件，保存为 PNG
python scripts/cutout.py --api face-cutout --image portrait.jpg --output face.png

# 人像抠图 — 返回 Base64 编码结果 + 68 点面部关键点
python scripts/cutout.py --api face-cutout --image portrait.jpg --base64 --face-analysis

# 照片增强 — 上传本地文件，保存高清图像
python scripts/cutout.py --api photo-enhancer --image blurry.jpg --output hd.png

# 照片增强 — 动漫/卡通图像超分辨率增强
python scripts/cutout.py --api photo-enhancer --image anime.jpg --face-model anime

# 预览模式（0.25 积分，最大尺寸 500×500）
python scripts/cutout.py --api bg-remover --image photo.jpg --preview

3. 参数说明

4. 输出说明

处理后的图像保存至 data/outputs/ 目录，命名格式为：{api}_{timestamp}.png

元数据将另存为 .meta.json 文件，内容包括：API 类型、所用参数、处理耗时及文件大小。

与其他工具集成

• 图像编辑：先执行背景移除，再合成新背景
• 头像生成：人像抠图 → 裁剪 → 生成头像
• 照片修复：照片增强 → 背景移除 → 合成输出

限制与配额

• 支持格式：PNG、JPG、JPEG、BMP、WEBP
• 最大分辨率：4096×4096 像素
• 最大文件大小：15 MB
• 每秒请求数（QPS）限制：最高 5 个并发请求/秒
• 积分消耗：标准模式 1 积分/张图，预览模式 0.25 积分/张图

文件参考