Picsart

PicsArt/gen-ai-skills

Picsart's REST API exposed as MCP tools: background removal, image upscaling, effects, and a full suite of editing and generative media operations. The server connects over streamable HTTP at mcp.picsart.io/v1, so you can pipe Picsart's capabilities straight into Claude workflows without manually wrangling API keys or parsing responses. If you're building product photography pipelines, social media asset generators, or anything that needs programmatic image manipulation alongside generative AI, this gives you removal, enhancement, and style transfer in the same context as your prompts. The accompanying gen-ai-skills repo includes 20 skills for campaigns, localization, and batch processing, but the MCP server itself is the raw API surface.

GitHub stars: 4
tools: 80
auth: Required
transport: HTTP
last updated: Jul 6, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.picsart.io/v1 --name picsart

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http picsart https://mcp.picsart.io/v1

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 80 tools

Verified live against the running server on Nov 6, 2026.

image-remove-backgroundDiscover the magic of seamless background removal with our removebg service, powered by cutting-edge AI technology. Our sophisticated algorithm effortlessly identifies and isolates the foreground, ensuring every detail from the delicate intricacies of jewelry to the finest str...19 params

Discover the magic of seamless background removal with our removebg service, powered by cutting-edge AI technology. Our sophisticated algorithm effortlessly identifies and isolates the foreground, ensuring every detail from the delicate intricacies of jewelry to the finest str...

Parameters* required

auto_centerboolean

Automatically center the object. Works only, when output_type=cutout. We don't recommend using this flag when the object is visible only partially (e.g. half-cup or half-shoe is in the image). default: false

bg_blurinteger

Enter an integer value from 0 to +100.default: 0

bg_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other...

bg_heightinteger

Size, in pixels, for the height. If left blank, the background is left at its original height.

bg_image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.) If this has a value, the output value is dismissed.

bg_widthinteger

Size, in pixels, for the width. If left blank, the background is left at its original width.

formatstring

Optionally select one of the image formats (PNG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: PNG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modelstring

Optionally choose a specific AI model to use for this request. If not specified, a default model will be applied. Please note that the default model may change over time as Picsart continues to imp...one of

urn:air:picsart:model:picsart:sod@8.2 · urn:air:picsart:model:picsart:sod@10 · urn:air:picsart:model:picsart:sod@10.1 · urn:air:picsart:model:picsart:sod@11

default: urn:air:picsart:model:picsart:sod@10

output_typestring

Select one of the two output options. If you submit a photo of a person, **cutout** returns the person as a sticker while **mask** returns a mask photo of the person. one of mask · cutoutdefault: cutout

scalestring

Fit is where the longer side (width/height) fits the background. Fill is where the shorter side fits the background. Fit is the default. one of fit · filldefault: fit

shadowstring

A universal parameter to configure the shadow. The default value is "disabled" and it will make sure that the shadow is not rendered. The "custom" value allows to define custom position for the sha...one of disabled · custom · bottom-right · bottom · bottom-left · leftdefault: disabled

shadow_blurinteger

Shadow Blur. Works when shadow is enabled.default: 50

shadow_offset_xinteger

Shadow Offset X. This is mandatory to specify when shadow=custom.

shadow_offset_yinteger

Shadow Offset Y. This is mandatory to specify when shadow=custom.

shadow_opacityinteger

Shadow Opacity. Works when shadow is enabled (a non-disabled value).default: 20

stroke_colorstring

Define the color of the stroke. Can be a hexcolor code (e.g., #82d5fa, #fff; with or without #) or a color name (e.g., blue; in English). For semi-transparency, 4-/8-digit hexcodes are also su...default: FFFFFF

stroke_opacityinteger

Define the opacity of the stroke added to the cutout result. Works when output_type=cutout and stroke_size is 1 and above. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it...default: 100

stroke_sizeinteger

Add a solid stroke (border) around the cutout result. Works when output_type=cutout. Set 0 to remove. Takes values from 0 to 100. default: 0

image-upscaleThe *upscale* service increases the resolutions of an image by a given upscale factor, without increasing its file size. Upscale increases the quality and resolution of your photos by leveraging predictive and generative AI to add pixels to your image. It works especially well...3 params

The *upscale* service increases the resolutions of an image by a given upscale factor, without increasing its file size. Upscale increases the quality and resolution of your photos by leveraging predictive and generative AI to add pixels to your image. It works especially well...

Parameters* required

formatstring

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

upscale_factorinteger

Choose one of the upscale factors. The options are as follows * 2 * 4 * 6 * 8 one of 2 · 4 · 6 · 8default: 2

image-ultra-upscale*Upscale Ultra* is a new upscaling technique which does upscaling with noise suppression. It works well on images with faces, small resolution images, stickers and objects with geometric shapes and clear edges. Upscale ultra increases the quality and resolution of low quality...5 params

*Upscale Ultra* is a new upscaling technique which does upscaling with noise suppression. It works well on images with faces, small resolution images, stickers and objects with geometric shapes and clear edges. Upscale ultra increases the quality and resolution of low quality...

Parameters* required

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_typestring

Optionally define your image type. If you know what your image is about, it's better this type is provided. It will help the service optimize and use the best model for that image type. Available o...one of product · portrait · nature · graphics

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modestring

Deprecated. The mode parameter is now deprecated. To control synchronous vs asynchronous execution, use the standard HTTP Prefer header (RFC 7240). If both mode and Prefer are provided, Prefer take...one of sync · async · autodefault: sync

upscale_factorinteger

Upscale an image with a given upscale factor. The upscale factor increases the image’s resolution without increasing its size. Upscale factor can be between 2 - 16 (default is 2). one of 2 · 3 · 4 · 5 · 6 · 7default: 2

image-ultra-upscale-getresultUse this method, along with transaction_id, to retrieve the upscale ultra finished image if the transformation was done asynchronously. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.1 params

Use this method, along with transaction_id, to retrieve the upscale ultra finished image if the transformation was done asynchronously. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

transaction_id*string

The ID returned from the POST method when it's done asynchronously.

image-ultra-enhance*Ultra enhance* is a new upscaling technique with a generative model which provides high frequency detail. It works well on images without noise and preserves details in a superior way. **Limitations:** **Minimums/Maximums:** * Up to 64Mpx output images **Examples:** Examples...3 params

*Ultra enhance* is a new upscaling technique with a generative model which provides high frequency detail. It works well on images without noise and preserves details in a superior way. **Limitations:** **Minimums/Maximums:** * Up to 64Mpx output images **Examples:** Examples...

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

upscale_factorinteger

image-face-enhanceWith our *enhance face* tool, you can turn your old, blurry photos into clear portraits and selfies. ur AI technology will find faces, perform restoration and do color enhancement simultaneously. It will improve the skin texture and sharpen details while keeping a good balance...2 params

With our *enhance face* tool, you can turn your old, blurry photos into clear portraits and selfies. ur AI technology will find faces, perform restoration and do color enhancement simultaneously. It will improve the skin texture and sharpen details while keeping a good balance...

Parameters* required

formatstring

Optionally select one of the image formats (JPG is the default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-list-effect-namesThis service retrieves a list of supported effects.

This service retrieves a list of supported effects.

No parameters. Call it with no arguments.

image-apply-effectWith the *effects* service you can apply up to 24 different effects to an image.4 params

With the *effects* service you can apply up to 24 different effects to an image.

Parameters* required

effect_namestring

Choose an effect from the dropdown menu. The list of effects are as follows * 1972 * apr1 * apr2 * apr3 * blur * gblur * lensblur * motionblur * smartblur * pixelize * brl1...one of 1972 · apr1 · apr2 · apr3 · blur · gblur

fadeinteger

Fade the effect. 0 means no fade and 100 means it's disabled. Note that some effects do not support fade: * lensblur * light1 * light10 * light11 * light12 * light13 * light14 * lig...default: 0

formatstring

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-create-effect-previewsThe *effects previews* service applies an effect to a given input image and returns a preview (i.e., thumbnail) of the effect.5 params

The *effects previews* service applies an effect to a given input image and returns a preview (i.e., thumbnail) of the effect.

Parameters* required

effect_namesarray

Select up to 10 effects. The list of effects are as follows: * 1972 * apr1 * apr2 * apr3 * blur * gblur * lensblur * motionblur * smartblur * pixelize * brl1 * brnz1 * brn...

fadeinteger

Fade the effect. 0 means no fade and 100 means it's disabled. Note that some effects do not support fade: * lensblur * light1 * light10 * light11 * light12 * light13 * light14 * lig...default: 0

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

preview_sizeinteger

Enter the width of the preview image. The max value is 240px. The default is 120px.default: 120

image-apply-laser-engraving-effectApply a laser engraving effect to your stickers.4 params

Apply a laser engraving effect to your stickers.

Parameters* required

background_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). default: white

engrave_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). default: black

formatstring

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP * SVG one of JPG · PNG · WEBP · SVGdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-list-ai-effect-namesThis service retrieves the list of supported AI effects.

This service retrieves the list of supported AI effects.

No parameters. Call it with no arguments.

image-apply-ai-effectWith the *AI Effects* service you can apply up to 40+ different AI effects to an image.3 params

With the *AI Effects* service you can apply up to 40+ different AI effects to an image.

Parameters* required

effect_namestring

Choose an effect from the dropdown menu. The list of effects are as follows * winterblues * wispy * geode * 744 * sketchy * dystopia * libtest2 * pastel * moonlight * rainbow...one of winterblues · wispy · geode · 744 · sketchy · dystopia

formatstring

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-adjustThe *adjust* service applies adjustments to an input image. There are 11 different adjustments in all available. The adjust service can be used with all photo types.13 params

The *adjust* service applies adjustments to an input image. There are 11 different adjustments in all available. The adjust service can be used with all photo types.

Parameters* required

brightnessinteger

Enter an integer value from -100 to +100.default: 0

clarityinteger

Enter an integer value from -100 to +100.default: 0

contrastinteger

Enter an integer value from -100 to +100.default: 0

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

highlightsinteger

Enter an integer value from -100 to +100.default: 0

hueinteger

Enter an integer value from -100 to +100.default: 0

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

noiseinteger

Enter an integer value from 0 to +100.default: 0

saturationinteger

Enter an integer value from -100 to +100.default: 0

shadowsinteger

Enter an integer value from -100 to +100.default: 0

sharpeninteger

Enter an integer value from 0 to +100.default: 0

temperatureinteger

Enter an integer value from -100 to +100.default: 0

vignetteinteger

Enter an integer value from 0 to +100.default: 0

image-selective-blurUse AI to define the segment that should be blurred, e.g. foreground or background, faces or car plates.4 params

Use AI to define the segment that should be blurred, e.g. foreground or background, faces or car plates.

Parameters* required

blurinteger

The blur amount to add.default: 50

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

segmentstring

The segment to add the blur effect to. Use either 'foreground', or 'background', or define the name of the segments such as 'faces' or 'car plates'. Recommendation: use short and clear names of the...

image-transfer-colorThe *color transfer* tool transfers the color style from a reference image to the target image.3 params

The *color transfer* tool transfers the color style from a reference image to the target image.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

reference_image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-transfer-styleThe *style transfer* tool transfers a style from a reference image to a content image. The smart algorithm blends the two images together so the output looks like the content image, but "painted" in the style of the reference image.4 params

The *style transfer* tool transfers a style from a reference image to a content image. The smart algorithm blends the two images together so the output looks like the content image, but "painted" in the style of the reference image.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

levelstring

Select a level from the dropdown menu. Smaller numbers preserve more from the original image, bigger numbers make the original image look closer to the reference image. The level options are as fol...one of l1 · l2 · l3 · l4 · l5default: l1

reference_image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-create-mask-previewsThe *masks previews* service applies mask effects to a given input image and returns a preview (i.e., thumbnail) of the effect.8 params

The *masks previews* service applies mask effects to a given input image and returns a preview (i.e., thumbnail) of the effect.

Parameters* required

blendstring

Select one of the appearance types from the list (it will be _screen_ if left blank). The options are as follows. * normal * screen * overlay * multiply * darken * lighten * add one of normal · screen · overlay · multiply · darken · lightendefault: screen

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: PNG

hueinteger

Enter an integer value from -180 to +180.default: 0

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

maskarray

Select up to 10 mask types from the list. The options are as follows * lace1 * lace2 * lace3 * lace4 * shdw2 * shdw17 * rpl3 * rpl5 * prsm3 * prsm9 * prsm10

mask_flipstring

Choose a mask flip option. The choices are as follows. * left * right * mirror horizontal * mirror vertical * turnaround one of left · right · mirror horizontal · mirror vertical · turnaround

opacityinteger

Enter an integer value from 0 to +100. The larger the number, the greater the opacity.default: 100

preview_sizeinteger

Enter the max size for the width or height of the preview image. The max value is 240px. If left blank it's 120px.default: 120

image-apply-maskThe *masks* service applies a mask to an image.7 params

The *masks* service applies a mask to an image.

Parameters* required

blendstring

Select one of the appearance types from the list (_screen_ is chosen if left blank). The options are as follows: * normal * screen * overlay * multiply * darken * lighten * add one of normal · screen · overlay · multiply · darken · lightendefault: screen

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: PNG

hueinteger

Enter an integer value from -180 to +180. Default is 0.default: 0

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

maskstring

Select one of the mask types from the list. The options are as follows: * lace1 * lace2 * lace3 * lace4 * shdw2 * shdw17 * rpl3 * rpl5 * prsm3 * prsm9 * prsm10 one of lace1 · lace2 · lace3 · lace4 · shdw2 · shdw17

mask_flipstring

Choose a mask flip option. The choices are as follows. * left * right * mirror horizontal * mirror vertical * turnaround one of left · right · mirror horizontal · mirror vertical · turnaround

opacityinteger

Enter an integer value from 0 to +100. The larger the number, the greater the opacity. Default is 100.default: 100

image-generate-textureThis service is now renamed to [Pattern Generator](https://docs.picsart.io/reference/image-generate-pattern). This name is now deprecated and we recommend moving all integratings to using the new name.9 params

This service is now renamed to [Pattern Generator](https://docs.picsart.io/reference/image-generate-pattern). This name is now deprecated and we recommend moving all integratings to using the new name.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Specify the height of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

offset_xinteger

Specify the pattern location, with x(width). Calculation starts from the center of the image. Default is 0.default: 0

offset_yinteger

Specify the pattern location with y(height). Calculation starts from the center of the image. Default is 0.default: 0

patternstring

Choose a pattern for the background texture. Default is hex.one of hex · mirror · diamond · hex2 · tiledefault: hex

rotateinteger

Enter an integer value to rotate the texture pattern from -180 to +180. Default is 0.default: 0

scalenumber

Enter a floating point number between 0.5 - 10.0 to scale the background texture. Default is 1.0.default: 1

widthinteger

Specify the width of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

image-generate-patternThe *pattern generator* tool generates a background texture pattern for the input image. You can create unlimited patterns from the same source image.9 params

The *pattern generator* tool generates a background texture pattern for the input image. You can create unlimited patterns from the same source image.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Specify the height of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

offset_xinteger

Specify the pattern location, with x(width). Calculation starts from the center of the image. Default is 0.default: 0

offset_yinteger

Specify the pattern location with y(height). Calculation starts from the center of the image. Default is 0.default: 0

patternstring

Choose a pattern for the background texture. Default is hex.one of hex · mirror · diamond · hex2 · tiledefault: hex

rotateinteger

Enter an integer value to rotate the texture pattern from -180 to +180. Default is 0.default: 0

scalenumber

Enter a floating point number between 0.5 - 10.0 to scale the background texture. Default is 1.0.default: 1

widthinteger

Specify the width of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

image-vectorize-raster-to-svgWith the *vectorizer* tool you can instantly turn your raster image into high quality vector graphic as it converts a PNG image to a SVG image. Using geometric figures, like curves and lines, the vectorizer converts the pixel information of raster input into vector image, whic...2 params

With the *vectorizer* tool you can instantly turn your raster image into high quality vector graphic as it converts a PNG image to a SVG image. Using geometric figures, like curves and lines, the vectorizer converts the pixel information of raster input into vector image, whic...

Parameters* required

downscale_tointeger

Large images can be downscaled. Use -1 to turn off downscaling. Otherwise the image is downscaled by 0.5 until max(width, height) < downscale_to. When downscale_to is disabled with -1, the image wi...default: 2048

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-design-importWith the *Design Import* tool you can instantly turn your design files (AI, SVG) into a Replay file (Picsart's proprietary project file format) that can be consumed by the [Photo and Video Editor SDK](https://docs.picsart.io/docs/photo-video-editor-overview). Use this to impor...2 params

With the *Design Import* tool you can instantly turn your design files (AI, SVG) into a Replay file (Picsart's proprietary project file format) that can be consumed by the [Photo and Video Editor SDK](https://docs.picsart.io/docs/photo-video-editor-overview). Use this to impor...

Parameters* required

filestring

Source file (binary). (If this parameter is present, the other source parameters must be empty.)

file_urlstring

Source file URL. (If this parameter is present, the other source parameters must be empty.)

image-design-import-getresultGet the result of the Design Import. Use the inference identifier from the POST request to fetch the latest status and result here. **Path Parameters:** - **transaction_id**: The ID returned from the POST method.1 params

Get the result of the Design Import. Use the inference identifier from the POST request to fetch the latest status and result here. **Path Parameters:** - **transaction_id**: The ID returned from the POST method.

Parameters* required

transaction_id*string

The ID returned from the POST method.

image-surfacemapWith the *surface map* tool you can "print" a sticker over an (target) image. Using a mask, the Surfacemap tool maps the sticker pixels using the texture and curves on the target image thus ultimately giving a live-print-preview effect.4 params

With the *surface map* tool you can "print" a sticker over an (target) image. Using a mask, the Surfacemap tool maps the sticker pixels using the texture and curves on the target image thus ultimately giving a live-print-preview effect.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

mask_urlstring

Source mask URL. (If this parameter is present, the other mask source parameters must be empty.)

sticker_urlstring

Source sticker URL. (If this parameter is present, the other sticker source parameters must be empty.)

image-add-watermarkAdd watermark to your image.10 params

Add watermark to your image.

Parameters* required

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

watermark_anchor_pointstring

Anchor point for the watermark.one of left-top · left-middle · left-bottom · center-top · center-middle · center-bottomdefault: left-bottom

watermark_angleinteger

Define the angle of the watermark. Takes values from 0 to 360.

watermark_heightvalue

Height of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas height like `"10%"` / `"12.5%"` (> 0, <= 100).

watermark_opacityinteger

Define the opacity of the watermark. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent. default: 50

watermark_padding_xvalue

Define the horizontal padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas width like `"2%"` (>= 0, <= 100). default: 0

watermark_padding_yvalue

Define the vertical padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas height like `"2%"` (>= 0, <= 100). default: 0

watermark_urlstring

Source watermark image URL. (If this parameter is present, the other watermark image source parameters must be empty.)

watermark_widthvalue

Width of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas width like `"10%"` / `"12.5%"` (> 0, <= 100).

image-uploadThe *upload* service is used to upload an image when you want to apply several transformations to it. By uploading an image first, you'll receive a transaction_id which you can use repeatedly for transformations and thereby avoid having to upload an image for each and every on...2 params

The *upload* service is used to upload an image when you want to apply several transformations to it. By uploading an image first, you'll receive a transaction_id which you can use repeatedly for transformations and thereby avoid having to upload an image for each and every on...

Parameters* required

imagestring

Source image file (binary). (If this parameter is present, the other image source parameters must be empty.)

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-getresultUse the image editing transaction ID to get the result image file URL. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.1 params

Use the image editing transaction ID to get the result image file URL. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

transaction_id*string

The ID returned from the POST method when it's done asynchronously.

image-credits-balanceCheck your balance of credits.

Check your balance of credits.

No parameters. Call it with no arguments.

image-editThe *Edit* service applies basic image editing to an input image. The basic editing operations are resize, crop, flip, rotate and perspective manipulation.14 params

The *Edit* service applies basic image editing to an input image. The basic editing operations are resize, crop, flip, rotate and perspective manipulation.

Parameters* required

crop_anchorstring

By default when crop_anchor or crop_x,crop_y pair are not provided, the crop will be done around the center of the image. This parameter is an easier option to crop_x,crop_y pair where the respecti...one of center · top-left · top-right · bottom-left · bottom-rightdefault: center

crop_xinteger

crop_x, toghether with crop_y, define the anchor point of the crop. This point will be the center of the crop area. The top-left corner corresponds to (0,0) point and the bottom-right corner corres...

crop_yinteger

crop_y, toghether with crop_x, define the anchor point of the crop. This point will be the center of the crop area. The top-left corner corresponds to (0,0) point and the bottom-right corner corres...

flipstring

Choose a way to flip the image.one of horizontal · vertical

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Height of outcome image. If the provided height is larger than the original width of the file, the original size of the image will be selected. When crop size is defined, but the x,y starting posit...

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modestring

For *crop* mode, the outcome image will be center-cropped with the given size (width, height). For the *resize* mode, the smallest size will be fitted to preserve the original proportion of the ima...one of resize · crop

perspective_horizontalinteger

The horizontal perspective after edits.default: 0

perspective_verticalinteger

The vertical perspective after edits.default: 0

qualityinteger

This refers to the level of accuracy of the image processing. The greater the quality (i.e., the larger the number), the larger the image file size. The default value is 90, which is a good comprom...default: 90

rotatenumber

Enter a float value to rotate the image from -180 to +180. Default is 0.default: 0

sizeinteger

When defined, this parameter overrides and applies the value for both width and height.

widthinteger

Width of outcome image. If the provided width is larger than the original width of the file, the original size of the image will be selected. When crop size is defined, but the x,y starting positio...

image-smart-cropUse AI to define the segment that should be cropped, e.g. foreground or product name (e.g. hat, gloves, boots, etc).7 params

Use AI to define the segment that should be cropped, e.g. foreground or product name (e.g. hat, gloves, boots, etc).

Parameters* required

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Specify the height of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

marginvalue

The margin to add around the crop segment. Values are defined in pixels. Accepts either a single value applied to all sides, or a CSS-like list of 1-4 values: * 1 value: all sides * 2 values: t...default: 0

ratiostring

Optionally enforce the ration of the result image. When both width and height parameters are provided, they should match this ratio. In case either width or height are provided, the other value wil...one of 1:1 · 4:3 · 3:2 · 16:9 · 21:9 · 4:5

segmentstring

The segment to crop. Use either 'foreground', or define the name of the segments such as 'hat' or 'boots'. Recommendation: use short and clear names of the segment (e.g. object or area). We don't r...

widthinteger

Specify the width of the output image in pixels.

image-blendWhether you're adding a custom watermark, layering in a texture, or composing multi-image layouts for eCommerce or social media, Blend service turns simple images into sophisticated visuals with just one call. This endpoint lets you seamlessly combine a base image with another...5 params

Whether you're adding a custom watermark, layering in a texture, or composing multi-image layouts for eCommerce or social media, Blend service turns simple images into sophisticated visuals with just one call. This endpoint lets you seamlessly combine a base image with another...

Parameters* required

blend_modestring

The blend mode. Choose one of normal, darken, multiply, lighten, screen, color_dodge, overlay, soft_light, hard_light, hue, saturation, color, luminosity. Defaults to normal. one of normal · darken · multiply · lighten · screen · color_dodgedefault: normal

formatstring

Optionally select one of the image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

opacityinteger

Define the opacity of the overlay added to the main image. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent. default: 100

overlay_image_urlstring

Overlay image URL. (If this parameter is present, the other image source parameters must be empty.) If this has a value, the output value is dismissed.

image-zoomZoom your images with 1-75 scale factors.4 params

Zoom your images with 1-75 scale factors.

Parameters* required

anchor_pointstring

Anchor point for zooming. Determines which part of the image to focus on. Expect longer response times when 'ai' is used.one of left-top · left-middle · left-bottom · center-top · center-middle · center-bottomdefault: center-middle

formatstring

Optionally select one of the image formats. Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

scale_factorinteger

The scale factor. 50 means 2x, and 75 means 1.5x.default: 2

image-segmentationPerforms multi-matting segmentation on the input image, identifying and isolating specific classes like hair, clothes, or sky.2 params

Performs multi-matting segmentation on the input image, identifying and isolating specific classes like hair, clothes, or sky.

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

segmentation_classstring

The type of segmentation to perform. Must be one of the following values: * hair * skin * lips * teeth * eyes * clothes * glasses * background * foreground * sky one of hair · skin · lips · teeth · eyes · clothes

image-taggingThis tagging service analyzes the image and suggests hashtags that are relevant to the content.1 params

This tagging service analyzes the image and suggests hashtags that are relevant to the content.

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-describerThe image *Describer* service helps generate a detailed text description for the provided image (image2text).1 params

The image *Describer* service helps generate a detailed text description for the provided image (image2text).

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

image-cars-classifierThe car image *Classifier* service categorizes all provided images. The supported categories are exterior, interior, engine, undercarriage, other. It is mandatory that the provided input image is a car image. If the image is not a car image, the service will not generate an er...2 params

The car image *Classifier* service categorizes all provided images. The supported categories are exterior, interior, engine, undercarriage, other. It is mandatory that the provided input image is a car image. If the image is not a car image, the service will not generate an er...

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modelstring

urn:air:openai:model:openai:gpt-6-astra@1 · urn:air:openai:model:openai:gpt-5@1 · urn:air:openai:model:openai:gpt-5.1@1 · urn:air:openai:model:openai:gpt-5.2@1 · urn:air:openai:model:openai:gpt-5.4@1 · urn:air:openai:model:openai:gpt-5.4-mini@1

default: urn:air:openai:model:openai:gpt-5.4-mini@1

image-extract-colorsExtract the key colors from an image to understand its visual style and palette. The service analyzes an image and returns up to five prominent colors, including dominant foreground and background tones.1 params

Extract the key colors from an image to understand its visual style and palette. The service analyzes an image and returns up to five prominent colors, including dominant foreground and background tones.

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

video-upscaleUpscale your video's resolution using Generative AI technology. Pick a model to match your footage — the Topaz families trade off speed against fidelity, and the default may change over time.4 params

Upscale your video's resolution using Generative AI technology. Pick a model to match your footage — the Topaz families trade off speed against fidelity, and the default may change over time.

Parameters* required

exportobject

modelstring

urn:air:topaz:model:topaz:proteus@1 · urn:air:topaz:model:topaz:artemis-hq@1 · urn:air:topaz:model:topaz:artemis-mq@1 · urn:air:topaz:model:topaz:artemis-lq@1 · urn:air:topaz:model:topaz:nyx@1 · urn:air:topaz:model:topaz:nyx-fast@1

default: urn:air:topaz:model:topaz:proteus@1

upscale_factorinteger

Upscale the video with a given upscale factor. Options are as follows * 2 * 3 * 4 The `flux-video-upscale` model supports factors 2 and 3 only; requests with 4 are rejected. one of 2 · 3 · 4default: 2

video_urlstring

Source video URL.

video-remove-backgroundRemove Background from videos, or replace with custom backdrops.3 params

Remove Background from videos, or replace with custom backdrops.

Parameters* required

bg_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For full transparency, use 'transparent' or '#00000000'. In this case, the export format .webm will be enforced and applie...default: #008800

bg_image_urlstring

The background image URL. Use either bg_color or bg_image_url. When not provided the default value of the bg_color=#008800 will be applied to the background.

video_urlstring

Source video URL.

video-adjustAdjusts the input video file with 14 different options. **Options:** * Adjust audio and/or volume * Adjust video volume * Adjust brightness and/or contrast * Adjust clarity and/or saturation * Adjust speed and/or reverse the video * Adjust hue and/or shadows * Adjust highlight...13 params

Adjusts the input video file with 14 different options. **Options:** * Adjust audio and/or volume * Adjust video volume * Adjust brightness and/or contrast * Adjust clarity and/or saturation * Adjust speed and/or reverse the video * Adjust hue and/or shadows * Adjust highlight...

Parameters* required

audio_urlstring

The sound file url.

audio_volumeinteger

The volume of the audio.default: 100

brightnessinteger

Enter an integer value from -100 to 100.default: 0

clarityinteger

Enter an integer value from -100 to 100.default: 0

contrastinteger

Enter an integer value from -100 to 100.default: 0

exportobject

highlightsinteger

Enter an integer value from -100 to 100.default: 0

hueinteger

Enter an integer value from -100 to 100.default: 0

saturationinteger

Enter an integer value from -100 to 100.default: 0

shadowsinteger

Enter an integer value from -100 to 100.default: 0

temperatureinteger

Enter an integer value from -100 to 100.default: 0

video_urlstring

Source video URL.

video_volumeinteger

The volume of the video.default: 100

video-apply-effectApply up to 24 different effects to a video.3 params

Apply up to 24 different effects to a video.

Parameters* required

effectsarray

Effects to be applied to the video, in the order they should be applied.

exportobject

video_urlstring

Source video URL.

video-editComprehensive editing with one operation. Apply effect, adjust, trim, crop, resize, change codecs, compression, framerates, etc. To re-encode a video into a different container, codec, frame rate or bitrate while leaving the picture itself untouched, send only the video source...4 params

Comprehensive editing with one operation. Apply effect, adjust, trim, crop, resize, change codecs, compression, framerates, etc. To re-encode a video into a different container, codec, frame rate or bitrate while leaving the picture itself untouched, send only the video source...

Parameters* required

cropvalue

exportobject

fitvalue

video_urlstring

Source video URL.

video-trimTrim the input video clip: pull a specific segment or trim to your desired video clip duration.4 params

Trim the input video clip: pull a specific segment or trim to your desired video clip duration.

Parameters* required

endinteger

This is the point in time of the video where the trimming ends in milliseconds. It must be greater than `start`.default: 1000

exportobject

startinteger

This is the point in time of the video from where the trimming begins in milliseconds.default: 0

video_urlstring

Source video URL.

video-cropCrop the input video clip to the desired size.6 params

Crop the input video clip to the desired size.

Parameters* required

exportobject

heightinteger

Height of the output video. If the new height is larger than the original height, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is...

start_xinteger

The starting x location of the crop in px as measured from the left edge.default: 0

start_yinteger

The starting y location of the crop in px as measured from the bottom edge.default: 0

video_urlstring

Source video URL.

widthinteger

Width of the outcome video. If the new width is larger than the original width, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value is t...

video-concatConcatenate several videos clips and images with transitions into one timeline. Helpful when adding intro/outro- or creating slideshows.8 params

Concatenate several videos clips and images with transitions into one timeline. Helpful when adding intro/outro- or creating slideshows.

Parameters* required

bg_audio_repeatboolean

Use true to repeat the audion in the background for the whole video duration or false if you want to play the audio only once.default: true

bg_audio_urlstring

Background audio/sound URL.

bg_audio_volumeinteger

Control the audio volume. Adjust from 0 to 100. 0 will mute the audio completely and 100 will have it at max.default: 100

exportobject

heightinteger

Height of the output video canvas. Unit is px.

itemsarray

List of videos and images to combine into a slideshow.

scalestring

Fit is where the longer side fits the background. Fill is where the shorter side fits. Options are as follows: * fit * fill one of fit · filldefault: fit

widthinteger

Width of the output video canvas. Unit is px.

video-concat-highlightsCreate a highlights video from the original one. This picks highlight clips and concatenates them into one output video.3 params

Create a highlights video from the original one. This picks highlight clips and concatenates them into one output video.

Parameters* required

exportobject

trim_segmentsarray

List of segments to combine/merge.

video_urlstring

Source video URL.

video-fitFit your original video to different ratios or width and height options. Apply fit when resizing and cropping is not an option.8 params

Fit your original video to different ratios or width and height options. Apply fit when resizing and cropping is not an option.

Parameters* required

bg_blurinteger

Enter an integer value from 0 to 100.default: 0

bg_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other...

bg_image_urlstring

Background image URL.

bg_video_urlstring

Background video URL.

heightinteger

Height of the outcome video. If the new height is larger than the original height, the blurry mirror effect should be applied to the additional part. The measurement unit is px. The default value i...

rationumber

The value should be a single floating point number which represents the ratio of width and height. The formula is: parameter value = width / height. The default value is that of the original video.

video_urlstring

Source video URL.

widthinteger

video-metadataAnalysis the Video and provides the Metadata.1 params

Analysis the Video and provides the Metadata.

Parameters* required

video_urlstring

Source video URL.

video-get-thumbnailExtracts (reads) Video Thumbnail.4 params

Extracts (reads) Video Thumbnail.

Parameters* required

image_formatstring

Optionally select one of the thumbnail image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

sourcestring

one of auto · container · timestampdefault: auto

timestampsarray

List up to 4 timestamps to extract frames from. <a href="https://docs.picsart.io/docs/video-timestamps/">Several timestamp formats</a> are supported.

video_urlstring

Source video URL.

video-set-thumbnailUpdate/Set the Video Thumbnail.2 params

Update/Set the Video Thumbnail.

Parameters* required

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

video_urlstring

Source video URL.

video-set-thumbnail-getresultUse this method, along with transaction_id, to retrieve the updated video with the new thumbnail. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.1 params

Use this method, along with transaction_id, to retrieve the updated video with the new thumbnail. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

transaction_id*string

The ID returned from the POST method when it's done asynchronously.

video-encode-ctvConverts your original video to meet <a href="https://docs.picsart.io/docs/ctv-ads-format-requirements/">CTV requirements</a>.1 params

Converts your original video to meet <a href="https://docs.picsart.io/docs/ctv-ads-format-requirements/">CTV requirements</a>.

Parameters* required

video_urlstring

Source video URL.

video-adjust-audioAdjusts the input video's audio volume, allows to add a new audio channel and control its volume.5 params

Adjusts the input video's audio volume, allows to add a new audio channel and control its volume.

Parameters* required

audio_urlstring

The sound file url.

audio_volumeinteger

The volume of the audio.default: 100

exportobject

video_urlstring

Source video URL.

video_volumeinteger

The volume of the video.default: 100

video-extract-audioExtract the input video's audio channel.2 params

Extract the input video's audio channel.

Parameters* required

formatstring

Optionally select one of the audio formats (mp3 is chosen if left blank). Options are as follows: * mp3 * m4a * wav * flac one of mp3 · m4a · wav · flacdefault: mp3

video_urlstring

Source video URL.

video-edit-audioComprehensive audio editing with one operation — the audio counterpart of Edit Video. Trim the audio, apply fades, adjust loudness, and change the format, bitrate and sample rate of the input audio. Send the audio source together with an `export` object describing the output y...9 params

Comprehensive audio editing with one operation — the audio counterpart of Edit Video. Trim the audio, apply fades, adjust loudness, and change the format, bitrate and sample rate of the input audio. Send the audio source together with an `export` object describing the output y...

Parameters* required

audio_urlstring

Source audio URL.

endinteger

The point in time of the audio where the trimming (in milliseconds) ends. It must be greater than `start`. Leave empty to trim to the end of the audio.

exportobject

Export options for the output audio.

fade_ininteger

Fade-in duration in milliseconds, applied from the beginning of the output.

fade_outinteger

Fade-out duration in milliseconds, applied to the end of the output. Cannot be combined with `trim_silence`.

normalizeboolean

Normalize loudness to a broadcast target of -16 LUFS. Cannot be combined with `volume`.

startinteger

The point in time of the audio from where the trimming (in milliseconds) begins.default: 0

trim_silenceboolean

Remove silence from the beginning and the end of the audio. Cannot be combined with `fade_out`.

volumenumber

Volume adjustment in dB. Negative values make the audio quieter, positive values louder. Cannot be combined with `normalize`.

video-transcribe-audioTranscribe your audio or video files. The input file can have one of the following mime types: * audio/flac * audio/mpeg * audio/x-m4a * audio/ogg * audio/x-wav * video/mp4 * video/mpeg * video/webm Note, that the maximum audio/video file size supported is 25mb.4 params

Transcribe your audio or video files. The input file can have one of the following mime types: * audio/flac * audio/mpeg * audio/x-m4a * audio/ogg * audio/x-wav * video/mp4 * video/mpeg * video/webm Note, that the maximum audio/video file size supported is 25mb.

Parameters* required

file_urlstring

Source video or audio URL. The maximum file size is 25mb.

formatstring

Optionally select one of the transcription formats (TXT is chosen if left blank). Options are as follows: * TXT * SRT * VTT * SBV one of TXT · SRT · VTT · SBVdefault: TXT

granularitystring

Define the granularity of the subtitles. This works for SRT, VTT and SBV formats only.one of 1-word · 2-words · sentencedefault: sentence

languagestring

Optionally select one of the languages in the 2-character format (ISO 639-1). Options are as follows: * Afrikaans - af * Arabic - ar * Armenian - am * Azerbaijani - az * Belarusian - be...one of af · ar · am · az · be · bsdefault: en

video-transcribe-audio-getresultUse this method, along with transaction_id, to retrieve the audio transcription. **Path Parameters:** - **transaction_id**: The Transaction ID returned from the [Transcribe Audio](https://docs.picsart.io/reference/video-transcribe-audio-1).1 params

Use this method, along with transaction_id, to retrieve the audio transcription. **Path Parameters:** - **transaction_id**: The Transaction ID returned from the [Transcribe Audio](https://docs.picsart.io/reference/video-transcribe-audio-1).

Parameters* required

transaction_id*string

The Transaction ID returned from the [Transcribe Audio](https://docs.picsart.io/reference/video-transcribe-audio-1).

video-add-watermarkAdd watermark to your video.9 params

Add watermark to your video.

Parameters* required

video_urlstring

Source video URL.

watermark_anchor_pointstring

Anchor point for the watermark.one of left-top · left-middle · left-bottom · center-top · center-middle · center-bottomdefault: left-bottom

watermark_angleinteger

Define the angle of the watermark. Takes values from 0 to 360.

watermark_heightvalue

Height of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas height like `"10%"` / `"12.5%"` (> 0, <= 100).

watermark_opacityinteger

Define the opacity of the watermark. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent. default: 50

watermark_padding_xvalue

Define the horizontal padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas width like `"2%"` (>= 0, <= 100). default: 0

watermark_padding_yvalue

Define the vertical padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas height like `"2%"` (>= 0, <= 100). default: 0

watermark_urlstring

Source watermark image URL. (If this parameter is present, the other watermark image source parameters must be empty.)

watermark_widthvalue

Width of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas width like `"10%"` / `"12.5%"` (> 0, <= 100).

video-getresultUse the video editing transaction ID to get the result video URL. This method works for effects, adjust, trim, crop, resize, fit, concatenation, highlights services. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.1 params

Use the video editing transaction ID to get the result video URL. This method works for effects, adjust, trim, crop, resize, fit, concatenation, highlights services. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

transaction_id*string

The ID returned from the POST method when it's done asynchronously.

video-getaudioresultUse the video editing transaction ID to get the result audio file URL. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.1 params

Use the video editing transaction ID to get the result audio file URL. **Path Parameters:** - **transaction_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

transaction_id*string

The ID returned from the POST method when it's done asynchronously.

video-uploadUpload resources such as videos, audios or images. The provided URL can be passed as inputs to video operation.1 params

Upload resources such as videos, audios or images. The provided URL can be passed as inputs to video operation.

Parameters* required

filestring

Source file (binary).

video-credits-balanceCheck your balance of credits.

Check your balance of credits.

No parameters. Call it with no arguments.

genai-text2text-completionsThe *Text2Text Completion* service helps generate a text based on the text introduced as input by the user. It also takes the pain out of writing to give your social, marketing, and advertising copy a premium edge.4 params

The *Text2Text Completion* service helps generate a text based on the text introduced as input by the user. It also takes the pain out of writing to give your social, marketing, and advertising copy a premium edge.

Parameters* required

max_completion_tokensinteger

An upper bound for the number of tokens that can be generated for a completion. default: 512

messagesarray

The messages containing the original text and instructions.

modelstring

urn:air:openai:model:openai:gpt-6-astra@1 · urn:air:openai:model:openai:gpt-5@1 · urn:air:openai:model:openai:gpt-5.1@1 · urn:air:openai:model:openai:gpt-5.2@1 · urn:air:openai:model:openai:gpt-5.4@1 · urn:air:openai:model:openai:gpt-5.4-mini@1

default: urn:air:openai:model:openai:gpt-5.4-mini@1

temperaturenumber

default: 1

genai-text2imageThe *Text2Image* service helps generate an image based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.5 params

The *Text2Image* service helps generate an image based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.

Parameters* required

countnumber

The number of images to generate.default: 2

heightnumber

Desired height used to determine the aspect ratio and resolution tier. The actual output height is determined by the AI provider based on the closest matching supported aspect ratio. Supported rati...default: 1024

modelstring

urn:air:sdxl:model:fluxai:flux_kontext_max@1 · urn:air:sdxl:model:fluxai:flux_kontext_pro@1 · urn:air:fluxai:model:fluxai:flux-2-flex@1 · urn:air:fluxai:model:fluxai:flux-2-pro@1 · urn:air:fluxai:model:fluxai:flux-2-max@1 · urn:air:fluxai:model:fluxai:flux-2-pro-preview@1

default: urn:air:fluxai:model:fluxai:flux-2-pro@1

promptstring

The prompt.

widthnumber

Desired width used to determine the aspect ratio and resolution tier. The actual output width is determined by the AI provider based on the closest matching supported aspect ratio. Supported ratios...default: 1024

genai-text2image-getresultGet the generated images. **Path Parameters:** - **inference_id**: The ID returned from the POST method when it's done asynchronously.1 params

Get the generated images. **Path Parameters:** - **inference_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

inference_id*string

The ID returned from the POST method when it's done asynchronously.

genai-text2stickerThe *Text2Sticker* service helps generate a sticker based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.5 params

The *Text2Sticker* service helps generate a sticker based on the text introduced as input by the user. The result images can be as big as 1024x1024 pixels.

Parameters* required

countnumber

The number of images to generate.default: 2

heightnumber

modelstring

urn:air:sdxl:model:fluxai:flux_kontext_max@1 · urn:air:sdxl:model:fluxai:flux_kontext_pro@1 · urn:air:fluxai:model:fluxai:flux-2-flex@1 · urn:air:fluxai:model:fluxai:flux-2-pro@1 · urn:air:fluxai:model:fluxai:flux-2-max@1 · urn:air:fluxai:model:fluxai:flux-2-pro-preview@1

default: urn:air:fluxai:model:fluxai:flux-2-pro@1

promptstring

The prompt.

widthnumber

genai-text2sticker-laser-engravingThis service generates stickers similar to the standard /text2sticker service, and in addition to that it adds a laser engraving effect. The result images can be as big as 1024x1024 pixels.8 params

This service generates stickers similar to the standard /text2sticker service, and in addition to that it adds a laser engraving effect. The result images can be as big as 1024x1024 pixels.

Parameters* required

background_colorstring

Can be a hexcolor code (e.g., #82d5fa, #fff) or a color name (e.g., blue). For semi-transparency, 4-/8-digit hexcodes are also supported (e.g., #18d4ff87). (If this parameter is present, the other...default: white

countnumber

The number of images to generate.default: 2

engrave_colorstring

formatstring

Optionally select one of the output image formats (JPG is chosen if left blank). Options are as follows: * JPG * PNG * WEBP * SVG one of JPG · PNG · WEBP · SVGdefault: JPG

heightnumber

modelstring

urn:air:sdxl:model:fluxai:flux_kontext_max@1 · urn:air:sdxl:model:fluxai:flux_kontext_pro@1 · urn:air:fluxai:model:fluxai:flux-2-flex@1 · urn:air:fluxai:model:fluxai:flux-2-pro@1 · urn:air:fluxai:model:fluxai:flux-2-max@1 · urn:air:fluxai:model:fluxai:flux-2-pro-preview@1

default: urn:air:sdxl:model:fluxai:flux_kontext_max@1

promptstring

The prompt.

widthnumber

genai-text2sticker-getresultGet the generated stickers. **Path Parameters:** - **inference_id**: The ID returned from the POST method when it's done asynchronously.1 params

Get the generated stickers. **Path Parameters:** - **inference_id**: The ID returned from the POST method when it's done asynchronously.

Parameters* required

inference_id*string

The ID returned from the POST method when it's done asynchronously.

genai-generate-logoGenerate logos using company info, general description. You can add additional information to guide on the details you want to get on the logo. It is also possible to provide an example logo to generate similar logos.7 params

Generate logos using company info, general description. You can add additional information to guide on the details you want to get on the logo. It is also possible to provide an example logo to generate similar logos.

Parameters* required

brand_namestring

Simply add your brand or company name.

business_descriptionstring

Describe your business, what it does. This information will be used to create logos that describe your brand.

color_tonestring

Optionally select one of the color tones for the generated logos (Auto is default). Options are as follows: * Auto * Gray * Blue * Pink * Orange * Brown * Yellow * Green * Purple...one of Auto · Gray · Blue · Pink · Orange · Browndefault: Auto

countnumber

The number of logos to generate.default: 2

logo_descriptionstring

Describe your logo details. What elements and details it should include, and how you imagine it should look like.

modelstring

urn:air:sdxl:model:fluxai:flux_kontext_max@1 · urn:air:sdxl:model:fluxai:flux_kontext_pro@1 · urn:air:fluxai:model:fluxai:flux-2-flex@1 · urn:air:fluxai:model:fluxai:flux-2-pro@1 · urn:air:fluxai:model:fluxai:flux-2-max@1 · urn:air:fluxai:model:fluxai:flux-2-pro-preview@1

default: urn:air:fluxai:model:fluxai:flux-2-pro@1

reference_image_urlstring

Reference logo URL. (If this parameter is present, the other reference logo parameters must be empty.)

genai-generate-logo-getresultGet the results of your logo generation. Use the inference identifier from the [Logo Generator](https://docs.picsart.io/reference/genai-generate-logo). **Path Parameters:** - **inference_id**: The inference identifier returned from the POST method [Logo Generator](https://docs...1 params

Get the results of your logo generation. Use the inference identifier from the [Logo Generator](https://docs.picsart.io/reference/genai-generate-logo). **Path Parameters:** - **inference_id**: The inference identifier returned from the POST method [Logo Generator](https://docs...

Parameters* required

inference_id*string

The inference identifier returned from the POST method [Logo Generator](https://docs.picsart.io/reference/genai-generate-logo).

genai-image-editEdit any image with a prompt. Apply any transformation, any type of detail you can imaging and the AI will apply it to the image. Choose from the big range of models if you have preferences or to take control of the output quality.17 params

Edit any image with a prompt. Apply any transformation, any type of detail you can imaging and the AI will apply it to the image. Choose from the big range of models if you have preferences or to take control of the output quality.

Parameters* required

countinteger

The number of images to generate.default: 2

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Desired output height. When unset, derived from the input image dimensions.

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modestring

modelstring

urn:air:sdxl:model:fluxai:flux_kontext_max@1 · urn:air:sdxl:model:fluxai:flux_kontext_pro@1 · urn:air:fluxai:model:fluxai:flux-2-flex@1 · urn:air:fluxai:model:fluxai:flux-2-pro@1 · urn:air:fluxai:model:fluxai:flux-2-max@1 · urn:air:fluxai:model:fluxai:flux-2-pro-preview@1

default: urn:air:sdxl:model:fluxai:flux_kontext_max@1

promptstring

The prompt.

watermark_anchor_pointstring

one of left-top · left-middle · left-bottom · center-top · center-middle · center-bottomdefault: left-bottom

watermark_angleinteger

Define the angle of the watermark. Takes values from 0 to 360. Default 45 for pattern case, otherwise 0.

watermark_enabledboolean

Enables the watermark. This is primarily used to show that the image is AI-generated, but this can be used for other use cases as well. When enabled, the default watermark will be added. When custo...default: false

watermark_heightvalue

Height of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas height like `"10%"` / `"12.5%"` (> 0, <= 100).

watermark_opacityinteger

Define the opacity of the watermark. Takes values from 0 to 100. Default is 100 (opaque). Set to 0 to make it transparent. default: 50

watermark_padding_xvalue

Define the horizontal padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas width like `"2%"` (>= 0, <= 100). default: 0

watermark_padding_yvalue

Define the vertical padding of the watermark. A pixel value like `20` (>= 0), or a percentage of the canvas height like `"2%"` (>= 0, <= 100). default: 0

watermark_urlstring

URL of the watermark image. If omitted or empty and watermark_enabled is true, a default watermark is applied.

watermark_widthvalue

Width of watermark. A pixel value like `100` (>= 1), or a percentage of the canvas width like `"10%"` / `"12.5%"` (> 0, <= 100).

widthinteger

Desired output width. When unset, derived from the input image dimensions.

genai-image-inpaintingThe **Inpainting** service offers inpainting (image2Image) capabilities, enabling users to fill or replace areas within an image based on specified criteria. It operates in two modes: * Single Image Mode: Submit one RGBA image. The API fills the specified inner area with conte...6 params

The **Inpainting** service offers inpainting (image2Image) capabilities, enabling users to fill or replace areas within an image based on specified criteria. It operates in two modes: * Single Image Mode: Submit one RGBA image. The API fills the specified inner area with conte...

Parameters* required

countinteger

The number of images to generate.default: 2

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

mask_image_urlstring

Source mask URL. (If this parameter is present, the other mask source parameters must be empty.)

modestring

promptstring

The prompt.

genai-image-outpaintingThe **Outpainting** service enables outpainting (image2image), allowing users to extend or replace specific parts of an image. This is a reversed form of the Inpainting service (drawing outside of the mask, not inside). It supports two operational modes: * Single Image Mode: U...6 params

The **Outpainting** service enables outpainting (image2image), allowing users to extend or replace specific parts of an image. This is a reversed form of the Inpainting service (drawing outside of the mask, not inside). It supports two operational modes: * Single Image Mode: U...

Parameters* required

countinteger

The number of images to generate.default: 2

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

mask_image_urlstring

Source mask URL. (If this parameter is present, the other mask source parameters must be empty.)

modestring

promptstring

The prompt.

genai-remove-objectThis service allows to remove objects from the original image by providing a mask. Even though the same type of a result can also achieved via the [Inpainting](https://docs.picsart.io/reference/genai-image-inpainting) service, this service uses a specially trained model to pro...4 params

This service allows to remove objects from the original image by providing a mask. Even though the same type of a result can also achieved via the [Inpainting](https://docs.picsart.io/reference/genai-image-inpainting) service, this service uses a specially trained model to pro...

Parameters* required

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

mask_image_urlstring

Source mask URL. (If this parameter is present, the other mask source parameters must be empty.)

modestring

genai-smart-backgroundThe **Smart Background** service elevates photo customization to new heights by offering an innovative solution for altering the backdrop of images. Unlike the traditional "Change Background" feature accessed via the /removebg endpoint, where users must provide a specific imag...6 params

The **Smart Background** service elevates photo customization to new heights by offering an innovative solution for altering the backdrop of images. Unlike the traditional "Change Background" feature accessed via the /removebg endpoint, where users must provide a specific imag...

Parameters* required

countinteger

The number of images to generate.default: 2

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modestring

negative_promptstring

The negative prompt (don’t generate this type of images). Don't use the negative keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'.

prompt*string

The prompt.

genai-expand-imageThe **Image Expansion** service offers a groundbreaking functionality designed to enhance digital imagery by enabling users to enlarge any image to specific width and height dimensions. This sophisticated feature not only allows generative resizing but also provides the capabi...9 params

The **Image Expansion** service offers a groundbreaking functionality designed to enhance digital imagery by enabling users to enlarge any image to specific width and height dimensions. This sophisticated feature not only allows generative resizing but also provides the capabi...

Parameters* required

countinteger

The number of images to generate.default: 2

directionstring

Use this parameter to define in which direction the source image should be expanded. Available values are: * center: Add pixels and expand the image from all sides. The original image will remain...one of center · top-left · top-right · bottom-left · bottom-rightdefault: center

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

heightinteger

Specify the width of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

modestring

negative_promptstring

Deprecated. The negative prompt (don’t generate this type of images). Don't use the nagitve keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'.

prompt*string

The prompt.

widthinteger

Specify the width of the output image in pixels. The default is 1024 and the maximum acceptable value is 8000.default: 1024

genai-generate-image-bleedThis service offers a groundbreaking functionality designed to enhance digital imagery by enabling users to enlarge any image. This service enlarges the original images and generates additional pixels around the original from all sides. This helps print original images without...5 params

This service offers a groundbreaking functionality designed to enhance digital imagery by enabling users to enlarge any image. This service enlarges the original images and generates additional pixels around the original from all sides. This helps print original images without...

Parameters* required

bleed_size*integer

Specify the bleed of the output image in pixels. When specifying the value, take into account the DPI of the image. For example, for 300DPI and the 0.125inches bleed, the value should be 300*0.125=...default: 5

formatstring

Optionally select one of the image formats (JPG is default). Options are as follows: * JPG * PNG * WEBP one of JPG · PNG · WEBPdefault: JPG

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

negative_promptstring

Deprecated. The negative prompt (don’t generate this type of images). Don't use the nagitve keywords such as 'no', e.g. don't use 'no distorted faces', use 'distorted faces'.

promptstring

The prompt. Only apply if you are confident the provided prompt is going to generate good results. Otherwise leave empty as the default prompt is already optimized for bleed generation.

genai-image-inpainting-getresultInpaint, Outpaint, Smart Background and Expand services can work asynchronously and expose an inference identifier that can be used later to fetch te results. Use this service to check up on the result. **Path Parameters:** - **inference_id**: The painting inference identifier.1 params

Inpaint, Outpaint, Smart Background and Expand services can work asynchronously and expose an inference identifier that can be used later to fetch te results. Use this service to check up on the result. **Path Parameters:** - **inference_id**: The painting inference identifier.

Parameters* required

inference_id*string

The painting inference identifier.

genai-text2videoThe *Text2Video* service helps generate a video based on the text introduced as input by the user. Considering the time and cost to generate videos, only one video will be generated per request (unlike the image generation services). Note, that considering the big number of di...7 params

The *Text2Video* service helps generate a video based on the text introduced as input by the user. Considering the time and cost to generate videos, only one video will be generated per request (unlike the image generation services). Note, that considering the big number of di...

Parameters* required

audioboolean

Generate the video with audio or not. Some models (e.g. Grok Imagine Video / OVI) don't support the option to disable sound. With these models the result video will always be generated regardless t...default: false

heightnumber

lengthnumber

Desired video length in seconds. Mapped to the closest supported duration for the selected model. default: 3

modelstring

Optionally choose a specific AI model to use for this video generation. If not specified, a default model will be applied. Please note that the default model may change over time as Picsart continu...one of

urn:air:seedance:model:seedance:seedance-1.0-pro@1 · urn:air:seedance:model:seedance:seedance-1.0-pro-fast@1 · urn:air:seedance:model:seedance:seedance-1.5-pro@1 · urn:air:seedance:model:seedance:seedance-2.0@1 · urn:air:seedance:model:seedance:seedance-2.0-fast@1 · urn:air:seedance:model:seedance:seedance-2.0-mini@1

default: urn:air:wan:model:wan:wan-2.7@1

promptstring

The prompt.

qualitystring

Video output quality/resolution.one of 480p · 720p · 1080pdefault: 480p

widthnumber

genai-image2videoThe *Image2Video* service helps generate a video based on the text introduced as input by the user. Considering the time and cost to generate videos, only one video will be generated per request (unlike the image generation services). Note, that considering the big number of d...8 params

The *Image2Video* service helps generate a video based on the text introduced as input by the user. Considering the time and cost to generate videos, only one video will be generated per request (unlike the image generation services). Note, that considering the big number of d...

Parameters* required

audioboolean

heightnumber

image_urlstring

Source image URL. (If this parameter is present, the other image source parameters must be empty.)

lengthnumber

Desired video length in seconds. Mapped to the closest supported duration for the selected model. default: 3

modelstring

urn:air:seedance:model:seedance:seedance-1.0-pro@1 · urn:air:seedance:model:seedance:seedance-1.0-pro-fast@1 · urn:air:seedance:model:seedance:seedance-1.5-pro@1 · urn:air:seedance:model:seedance:seedance-2.0@1 · urn:air:seedance:model:seedance:seedance-2.0-fast@1 · urn:air:seedance:model:seedance:seedance-2.0-mini@1

default: urn:air:wan:model:wan:wan-2.7@1

promptstring

The prompt.

qualitystring

Video output quality/resolution.one of 480p · 720p · 1080pdefault: 480p

widthnumber