The ultimate asset-prep utility for transparent PNGs/WebPs. Automatically normalizes your output format, centers the subject, and injects a precise pixel margin to keep assets looking uniform.
One POST request. Get the result back directly — as an image, video, or JSON depending on the tool.
curl -X POST https://apiai.me/api/workflow/smart-crop \
-H "X-API-Key: YOUR_API_KEY" \
-F "image=@input.jpg" \
-F "alpha_threshold=10" \
-F "background=transparent" \
-F "format=square" \
-F "margin=10" \
-F "subject_scale=0"
--output result.png
Test this tool visually before writing any code. Upload an image, set parameters, and see the result live. When it looks right, copy the auto-generated curl command and paste it into your app.
Process hundreds of images at once without writing a loop. Upload a CSV with one row per item, set your parameters, and download the results as a ZIP when they're done.
| Name | Required | Description | Default / Options |
|---|---|---|---|
alpha_threshold |
optional | Minimum alpha (0-255) for a pixel to count as the subject — ignores faint semi-transparent edge pixels. | 10
|
background |
optional | Padding fill colour. Options: transparent, white, or a hex colour like #ffffff. | transparent
|
format |
optional | Output aspect ratio. Options: original, 1:1, square, 3:4, 4:3, 3:2, 2:3, 9:16, 16:9, 4:5. Subject is centred and padded (never cropped). | original1:1square3:44:33:22:39:1616:94:5
|
margin |
optional | Padding around the subject in pixels. Ignored when subject_scale is set. | 10
|
subject_scale |
optional | Scale the subject to this % of the output's longest side, padding around it (e.g. 75). 0 = off. Needs a format other than original. | 0
|
Get an API key, test Transparent Crop in the dashboard, and copy the curl command.