Add padding to an image
POST /v1/process/pad
Add padding around an image to reach a target size. The gravity parameter controls where the original image is placed within the padded canvas.
This is a free operation — no credits charged.
Authorizations
Section titled “Authorizations ”Request Body
Section titled “Request Body ”object
Hex color for padding (default #FFFFFF).
Image placement within padded canvas (default ‘center’). One of: center, north, south, east, west, north-east, north-west, south-east, south-west.
Target height in pixels (1-16384).
HTTPS URL of the image to pad.
Target width in pixels (1-16384).
Responses
Section titled “ Responses ”OK
object
MIME type of the output image.
ISO 8601 expiry time of the signed URL.
Signed URL of the processed image. Expires in 1 hour.
Processing operation performed.
Bad Request
object
Unauthorized
object
Payment Required
object
Forbidden
object
Not Found
object
Conflict
object
Unprocessable Entity
object
Too Many Requests
object
Unavailable For Legal Reasons
object
Internal Server Error
object
Bad Gateway
object
Service Unavailable