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:
2. url must be a reachable image URL.

3. width and height must be integers in [1, 4096].

4. 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:
2. cropped_url
3. original_size
4. face_detected

Execute Crop by Upload

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

2. 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:
2. cropped_url
3. original_size
4. 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"
}