裁剪图像技能

服务端点

• API 基础 URL：https://api.imageclaw.net
• 健康检查：https://api.imageclaw.net/health
• 通过 URL 裁剪：https://api.imageclaw.net/crop
• 通过上传裁剪：https://api.imageclaw.net/crop/upload
• 文档：https://api.imageclaw.net/docs

通过 URL 执行裁剪

1. 校验输入字段：

• url 必须为可访问的图像 URL。
• width 和 height 必须为区间 [1, 4096] 内的整数。

2. 调用端点：

curl -sS -X POST "https://api.imageclaw.net/crop" 
  -H "content-type: application/json" 
  -d '{
    "url": "https://picsum.photos/800/600",
    "width": 256,
    "height": 256
  }'

3. 返回响应字段：

• cropped_url
• original_size
• face_detected

通过上传执行裁剪

1. 对于用户提供的本地文件，建议使用上传模式。

2. 调用端点：

curl -sS -X POST "https://api.imageclaw.net/crop/upload" 
  -F "file=@/absolute/path/to/photo.jpg" 
  -F "width=256" 
  -F "height=256"

3. 返回响应字段：

• cropped_url
• original_size
• face_detected

错误处理

• HTTP 400：图像源无效或解码失败
• HTTP 422：校验失败（URL 无效、width/height 无效）
• HTTP 500：服务或配置故障

发生错误时：

1. 返回原始状态码及 detail 字段。
2. 对于 400 或 422 错误，提示调用方修改输入参数。
3. 仅对临时性 500 错误或网络超时进行重试。

成功示例

{
  "cropped_url": "https://crop.imagebee.net/crops/1772761350_b8050bd6ec26.jpg",
  "original_size": [800, 600],
  "face_detected": false
}

失败示例

{
  "detail": "Not an image: content-type is application/json"
}