Photo Clipper 用于按自然语言提示裁剪照片。适用场景包括:裁剪或修剪照片、去除图像某部分(如“从顶部去掉 20%”)、聚焦特定主体或区域、改善构图(如应用三分法)、去除边缘干扰物、调整取景或宽高比。
主要流程:先校验输入,确保照片存在且为 JPG/PNG;再调用 GPT-5 视觉 API 依据用户提示给出裁剪建议;随后做安全校验,确保任一维度裁剪不超过 50%;应用裁剪并保存为新文件,不覆盖原图;最后报告被移除内容及 GPT-5 的推理。
使用方式:Python 导入 from photo_clipper import main,调用 main(photo_path="photo.jpg", prompt="Remove 20% from top to reduce empty sky"),返回 "photo-clipped.jpg"。命令行:python photo_clipper.py <photo_path> "<prompt>" [output_path]。示例提示包括去除空天空、聚焦人脸、去除左侧树木、应用三分法、各边去除 10%。
输出:返回裁剪后照片路径,不覆盖原图,格式为 {original_name}-clipped.{ext},并显示 GPT-5 的置信度与推理。错误处理:GPT-5 不可用时回退到安全默认(不裁剪);校验参数(每维度最多去除 50%);对缺失文件或无效格式给出明确错误信息。
要求:需设置 OPENROUTER_API_KEY 环境变量;照片须为 JPG 或 PNG;建议照片小于 50MB。技术实现细节见 references/implementation.md,常见用例见 examples/common-use-cases.md。其他收费、平台支持等信息暂未提供。