Filters

You can add a number of filters to your images using Filestack.

Note: The maximum accepted image size is 100,000,000 pixels. An image with this many pixels could have width and height combinations like 10,000 x 10,000 or 5,000 x 20,000, etc. There is also a file size restriction. Filestack will not convert an image that is larger than 256mb. Please contact us if you require the ability to process larger files than our current limits.

Task Quick Jump:

Sharpen Blur Monochrome Black & White Sepia Pixelate Oil Paint Negative Modulate Partial Pixelation Partial Blur


Sharpen

Sharpen Task URL Format:
https://process.filestackapi.com/sharpen=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/sharpen=[options]/File_URL

sharpen
String

The root task cannot be abbreviated

Users can use sharpen without any options and the default settings will be used.
sharpen=amount:5
Integer

Can be abbreviated as a:10

The amount to sharpen the image. The value for this parameter can be any integer in a range from 1 to 20. The default value for this parameter is 2.

Sharpen Examples

Original Image

original photo to be transformed using Filestack's sharpen filter

photo courtesy of Mike Mozey


Sharpen using default parameters sharpen:

photo transformed using Filestack's sharpen filter with default parameters

Sharpen with amount set to sharpen=amount:7:

photo transformed using Filestack's sharpen filter with amount set to seven

Blur

Blur Task URL Format:
https://process.filestackapi.com/blur=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/blur=[options]/File_URL

blur
String

The root task cannot be abbreviated

Users can use blur without any options and the default settings will be used.
blur=amount:10
Integer

Cannot be abbreviated as a:10

The amount to blur the image. The value for this parameter can be any integer in a range from 1 to 20. The default value for this parameter is 2.

Blur Examples

Original Image

original photo to be transformed using Filestack's blur filter

Blur using default parameters blur:

photo transformed using Filestack's blur filter with default settings

Blur with amount set to blur=amount:7:

photo transformed using Filestack's blur filter with amount set to seven

Monochrome

Monochrome Task URL Format:
https://process.filestackapi.com/monochrome/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/monochrome/File_URL

monochrome
String

The root task cannot be abbreviated

Monochrome requires no additional parameters. It is simply called like this: monochrome

Monochrome Example

Original Image

original photo to be transformed using Filestack's monochrome filter

Monochrome with default parameters monochrome:

photo transformed using Filestack's monochrome filter with default settings

Black & White

Black & White Task URL Format:
https://process.filestackapi.com/blackwhite=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/blackwhite=[options]/File_URL

blackwhite
String

The root task cannot be abbreviated

Users can use blackwhite without any options and the default settings will be used.
blackwhite=threshold:0 to 100
Integer

Can be abbreviated as t:50

Controls the balance between black and white (contrast) in the returned image. This parameter accepts integers between 1 and 100. The lower the number the less black appears in the picture. The higher the number the more black is represented. 0 returns an almost all white image. 100 returns an almost all black image. The default value is 50.

Black & White Example

Original Image

original photo to be transformed using Filestack's blackwhite filter

By Andy Wolfe - This Image was released by the United States Navy with the ID 110211-O-XX000-001 (next). Public Domain, https://commons.wikimedia.org/w/index.php?curid=16185482


Black & White with default parameters blackwhite:

original photo to be transformed using Filestack's blackwhite filter

Black & White with threshold set to 20 threshold:20:

original photo to be transformed using Filestack's blackwhite filter with threshold parameter set to 20

Black & White with threshold set to 75 threshold:75:

original photo to be transformed using Filestack's blackwhite filter with threshold parameter set to 75

Sepia

Sepia Task URL Format:
https://process.filestackapi.com/sepia=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/sepia=[options]/File_URL

sepia
String

The root task cannot be abbreviated

Users can use sepia without any options and the default settings will be used.
sepia=tone:80
String

Can be abbreviated as t:80

The value to set the sepia tone to. The value for this parameter can be any integer in a range from 0 to 100. The default value for this parameter is 80.

Sepia Example

Original Image

original photo to be transformed using Filestack's sepia filter

Sepia with default parameters sepia:

photo transformed using Filestack's sepia filter with default settings

Sepia with tone set to 50 tone:50:

photo transformed using Filestack's sepia filter with tone set to 50

Pixelate

Pixelate Task URL Format:
https://process.filestackapi.com/pixelate=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/pixelate=[options]/File_URL

pixelate
String

The root task cannot be abbreviated

Users can use pixelate without any options and the default settings will be used.
pixelate=amount:5
Integer

Can be abbreviated as a:10

The amount to pixelate the image. The value for this parameter can be any integer in a range from 2 to 100. The default value for this parameter is 2.

Pixelate Examples

Original Image

original photo to be transformed using Filestack's pixelation filter

Pixelate using default parameters pixelate:

photo transformed using Filestack's pixelation filter with default settings

Pixelate with amount set to pixelate=amount:7:

photo transformed using Filestack's pixelation filter with amount set to seven

Oil Paint

Oil Paint Task URL Format:
https://process.filestackapi.com/oil_paint=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/oil_paint=[options]/File_URL

oil_paint
String

The root task cannot be abbreviated

Users can use oil_paint without any options and the default settings will be used.
oil_paint=amount:5
Integer

Can be abbreviated as a:10

The amount to transform the image with the oil paint filter. The value for this parameter can be any integer in a range from 1 to 10. The default value for this parameter is 2.

Oil Paint Examples

Original Image

original photo to be transformed using Filestack's oil paint filter

Oil Paint using default parameters oil_paint:

photo transformed using Filestack's oil paint filter with default settings

Oil Paint with amount set to oil_paint=amount:7:

photo transformed using Filestack's oil paint filter with amount set to seven

Negative

Negative Task URL Format:
https://process.filestackapi.com/negative/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/negative/File_URL

negative
String

The root task cannot be abbreviated

The image returned by this transformation creates a negative image by portraying the lightest area as the darkest and the darkest areas as the lightest. The negative task requires no additional parameters. It is simply called like this: negative

Negative Filter Examples

Original Image

original photo to be transformed using Filestack's negative filter

By Jason Auch - originally posted to Flickr as IMG_0760, CC BY 2.0, https://commons.wikimedia.org/w/index.php?curid=9703652


Image transformed using default negative filter parameters negative:

original photo to be transformed using Filestack's negative filter with default settings

Modulate

Modulate Task URL Format:
https://process.filestackapi.com/modulate=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/modulate=[options]/File_URL

modulate
String

The root task cannot be abbreviated

Users can use modulate without any options and the default settings will be used.
modulate=brightness:155
Integer

Can be abbreviated as b:100

The amount to change the brightness of an image. The value for this parameter can be any integer in a range from 0 to 10000. The default value for this parameter is 100.
modulate=hue:155
Integer

Can be abbreviated as h:120

The degree to set the hue to. The value for this parameter can be any integer in a range from 0 to 359, where 0 is the equivalent of red and 180 is the equivalent of cyan. The default value for this parameter is 0.
modulate=saturation:155
Integer

Can be abbreviated as s:10

The amount to change the saturation of the image. The value for this parameter can be any integer in a range from 0 to 10000. The default value for this parameter is 100.

Modulate Examples

Original Image

original photo to be transformed using Filestack's modulation filter

Modulate using default parameters modulate:

The image should look identical to the original image when default parameters are used.

photo transformed using Filestack's modulation filter with default settings

Modulate with hue set to 240 modulate=brightness:100,hue:240,saturation:100:

photo transformed using Filestack's modulation filter with hue set to 240

Modulate with hue set to 240 and saturation set to 200 modulate=brightness:100,hue:240,saturation:200:

The pink hue becomes much more vivid, but some of the details of the image start to bleed together.

photo transformed using Filestack's modulation filter with hue set to 240 and saturation set to 200

Modulate with hue set to 240, saturation set to 200 and reduce the brightness to 80 modulate=brightness:100,hue:240,saturation:200:

photo transformed using Filestack's modulation filter with hue set to 240, saturation set to 200 and brightness set to 80

Partially Pixelate

Partial Pixelate Task URL Format:
https://process.filestackapi.com/partial_pixelate=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/partial_pixelate=[options]/File_URL

partial_pixelate=amount:10
Integer

Can be abbreviated as a:10

The amount to pixelate the image. The value for this parameter can be any integer in a range from 2 to 100. The default value for this parameter is 10.
partial_pixelate=blur:10
Float

Can be abbreviated as l:10

The amount to blur the image. The value for this parameter can be any float in a range from 0 to 20. The default value for this parameter is 4.0.
partial_pixelate=type:rect
String

Can be abbreviated as t:rect

The shape of the pixelated area. The value for this parameter is a string. The options are rect (for a rectangle shape) or oval (for an oval shape). The default value for this parameter is rect.
partial_pixelate=objects:[[x,y,width,height],[x,y,width,height]]
Multiple Arrays

Can be abbreviated as o:[[10,20,200,250],[275,91,500,557]]

The area(s) of the image to pixelate. This variable is an array of arrays. Each array input for this parameter defines a different section of the image and must have exactly 4 integers: 'x coordinate,y coordinate,width,height' - for example, partial_pixelate=objects:[[10,20,200,250]] selects a 200x250 pixel rectangle starting 10 pixels from the left edge of the image and 20 pixels from the top edge of the image. The values for these arrays can be any integer from 0 to 10000.

Partially Pixelated Examples

Original Image

original photo to be transformed with Filestack's partial pixelation filter

Pixelate several areas using default parameterspartial_pixelate=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]]:

photo transformed with Filestack's partial pixelation filter with default settings

Changing the shape of the pixelated areas to ovalspartial_pixelate=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]],type:oval:

photo transformed with Filestack's partial pixelation filter with oval pixelation areas

Partial pixelate using all the parameters partial_pixelate=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]],amount:100,blur:20:

photo transformed with Filestack's partial pixelation filter using all parameters

Partial Blur

Partial Blur Task URL Format:
https://process.filestackapi.com/partial_blur=[options]/Filestack_FileLink_Handle
or
https://process.filestackapi.com/<API_KEY>/partial_blur=[options]/File_URL

partial_blur=amount:10
Float

Can be abbreviated as a:10

The amount to blur the image. The value for this parameter can be any float in a range from 0 to 20 . The default value for this parameter is 4.0. The default value for this parameter is 10.
partial_blur=blur:10
Float

Can be abbreviated as l:10

The amount to blur the image. The value for this parameter can be any float in a range from 0 to 20. The default value for this parameter is 4.0.
partial_blur=type:rect
String

Can be abbreviated as t:rect

The shape of the blur area. The value for this parameter is a string. The options are rect (for a rectangle shape) or oval (for an oval shape). The default value for this parameter is rect.
partial_blur=objects:[[x,y,width,height],[x,y,width,height]]
Multiple Arrays

Can be abbreviated as o:[[10,20,200,250],[275,91,500,557]]

The area(s) of the image to blur. This variable is an array of arrays. Each array input for this parameter defines a different section of the image and must have exactly 4 integers: 'x coordinate,y coordinate,width,height' - for example, partial_blur=objects:[[10,20,200,250]] selects a 200x250 pixel rectangle starting 10 pixels from the left edge of the image and 20 pixels from the top edge of the image. The values for these arrays can be any integer from 0 to 10000.

Partial Blur Examples

Original Image

original photo to be transformed with the partial blur filter

Blurring several areas using default parameterspartial_blur=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]]:

photo transformed with Filestack's partial blur filter with default settings

Changing the shape of the blurred areas to ovalspartial_blur=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]],type:oval:

photo transformed with Filestack's partial blur filter with oval shaped blur areas

Partial blur using all the parameters partial_blur=objects:[[92,53,214,207],[754,140,129,153],[192,469,182,181],[704,434,219,183]],amount:15,blur:20:

photo transformed with Filestack's partial blur filter with all parameters used