crop-image（裁剪图像）

Crop Image Skill

Service Endpoints

• API Base URL: https://api.imageclaw.net
• Health: https://api.imageclaw.net/health
• Crop by URL: https://api.imageclaw.net/crop
• Crop by Upload: https://api.imageclaw.net/crop/upload
• Docs: https://api.imageclaw.net/docs

Execute Crop by URL

1. Validate input fields:

• url must be a reachable image URL.
• width and height must be integers in [1, 4096].

1. Call endpoint:

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
  }'

1. Return response fields:

• cropped_url
• original_size
• face_detected

Execute Crop by Upload

1. Prefer upload mode for user-provided local files.

1. Call endpoint:

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

1. Return response fields:

• cropped_url
• original_size
• face_detected

Error Handling

• HTTP 400: invalid image source or decode failure
• HTTP 422: validation failure (invalid URL, invalid width/height)
• HTTP 500: service or configuration failure

When failure occurs:

1. Return the original status code and detail.
2. Ask caller to change input for 400/422.
3. Retry only for transient 500 or network timeout.

Success Example

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

Failure Example

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