ImageClaw 图片裁剪

要解决什么问题

在对话或自动化流程里，你经常需要把一张远程图或用户本地图裁成固定宽高，而不是让调用方自己装 Pillow、处理 EXIF 或维护裁剪服务。若还要知道「有没有裁到脸」这类元数据，纯本地脚本往往要额外接检测模型。本技能把裁剪委托给 ImageClaw 的 HTTP API（https://api.imageclaw.net），由代理按约定校验参数、选端点并解释错误码。

技能如何工作

技能围绕两种入口组织调用逻辑：

• 按 URL 裁剪：请求 POST https://api.imageclaw.net/crop。url 必须是可访问的图片地址；width 与 height 为 [1, 4096] 内的整数。服务解码图片后按尺寸输出结果。
• 按上传裁剪：用户给出本地文件时，应优先走 POST https://api.imageclaw.net/crop/upload，避免把大文件先转成可公网 URL 的中间步骤。

成功时统一关注三个字段：cropped_url（裁剪结果地址）、original_size（原图尺寸）、face_detected（是否检测到人脸，便于判断构图是否偏了）。健康检查与 OpenAPI 文档分别对应 /health 与 /docs，便于在集成前确认服务可用。

边界与注意点

• 400：图源无效或解码失败——换图或检查 URL/文件格式，不要盲目重试。
• 422：参数校验失败（URL 不合法、宽高越界或非整数）——按提示改输入。
• 500 或网络超时：可视为短暂故障，在改输入无效的前提下再有限重试。

失败时应把原始状态码与 detail 回传给调用方；不要吞掉 422 里的校验信息。裁剪尺寸上限 4096，超大图需先在外部降采样或换策略。