Trim uniform borders

POST

/v1/process/trim

• Production
• Development

Automatically trim uniform-color borders from an image. The tolerance parameter controls how similar border pixels must be to be removed.

This is a free operation — no credits charged.

Authorizations

• ApiKeyAuth

Request Body

object

input_image_url

required

HTTPS URL of the image to trim.

string

tolerance

Color distance tolerance for border detection (0-255, default 10).

null | integer

Responses

200

OK

object

content_type

MIME type of the output image.

string

expires_at

ISO 8601 expiry time of the signed URL.

string

image_url

Signed URL of the processed image. Expires in 1 hour.

string

operation

Processing operation performed.

string

400

Bad Request

object

details

error

string

message

string

request_id

string

401

Unauthorized

object

details

error

string

message

string

request_id

string

402

Payment Required

object

details

error

string

message

string

request_id

string

403

Forbidden

object

details

error

string

message

string

request_id

string

404

Not Found

object

details

error

string

message

string

request_id

string

409

Conflict

object

details

error

string

message

string

request_id

string

422

Unprocessable Entity

object

details

error

string

message

string

request_id

string

429

Too Many Requests

object

details

error

string

message

string

request_id

string

451

Unavailable For Legal Reasons

object

details

error

string

message

string

request_id

string

500

Internal Server Error

object

details

error

string

message

string

request_id

string

502

Bad Gateway

object

details

error

string

message

string

request_id

string

503

Service Unavailable

object

details

error

string

message

string

request_id

string