Picsart Enterprise API
Agent-ready OpenAPI document · curated by JenticMediaImage ProcessingapiKey5 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Remove backgrounds from images and videos with AI precision, upscale images up to 16x resolution, replace backgrounds with colors or custom images, process images and videos asynchronously for batch operations, and track rate limits and credit usage so an agent can orchestrate media processing workflows.
Use for: I need to remove the background from a product image, Upscale a low-resolution image to 4K quality, Replace the background of a video with a custom image, Create transparent PNG cutouts from photos
Not supported: Does not handle image generation, style transfer, face editing, text overlay, collage creation, or social media templates - use only for background removal, background replacement, and image upscaling operations on existing images and videos.
Jentic publishes the only available OpenAPI specification for Picsart Enterprise API, keeping it validated and agent-ready. The Picsart API provides powerful image and video manipulation capabilities including AI-powered background removal with support for cutouts and custom backgrounds, image upscaling up to 16x resolution with both standard and ultra modes, video background removal and replacement, and support for multiple output formats including JPG, PNG, and WebP. It is designed for enterprise applications requiring batch image processing, e-commerce product photography, content creation workflows, and video editing automation. Authentication uses an API key in the Authorization header, with rate limiting and credit tracking exposed through response headers.
Install Jentic One Beta
Connect the Picsart Enterprise API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Picsart Enterprise API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpicsart.io%2Fpicsart" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpicsart.io%2Fpicsart" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Picsart Enterprise API.
Remove image backgrounds with AI precision via POST /removebg, preserving details like hair and jewelry
Replace backgrounds with custom images, solid colors, or blur effects
Output transparent cutouts or alpha masks for downstream compositing
Upscale images by 2x, 4x, 6x, or 8x with standard upscaling via POST /upscale
Ultra upscale images from 2x to 16x resolution with sync, async, or auto modes via POST /upscale/ultra
Poll asynchronous upscale results with GET /upscale/ultra/{transaction_id}
Remove and replace video backgrounds via POST /remove-background with async processing
Add strokes, borders, and shadows to cutout images
Support multiple output formats: JPG, PNG, WEBP
Track rate limits and credit consumption via response headers
Use Cases
Patterns agents use Picsart Enterprise API for, with concrete tasks.
★ E-commerce product photography automation
E-commerce platforms need clean, consistent product images with white or transparent backgrounds. The Picsart API automates this workflow: upload a product photo via POST /removebg with output_type 'cutout' and bg_color 'white' to generate a professional product image. For higher resolution, chain with POST /upscale using upscale_factor 4 to create 4K product images suitable for zoom and high-DPI displays. The API handles complex subjects like jewelry, clothing with textures, and items with fine details.
Call POST /removebg with image (URL or binary), output_type 'cutout', bg_color '#FFFFFF' to create white-background version. Capture the returned data.url, then call POST /upscale with that URL and upscale_factor 4 to generate 4K output. Store the final high-resolution image for the product catalog.
Content creator background replacement workflow
Social media content creators and marketers need to place subjects in different contexts without reshooting. Use POST /removebg with bg_image parameter to replace the background with a custom scene, or use bg_blur to create portrait-mode style effects. For video content, POST /remove-background processes video files asynchronously, returning a transaction_id to poll for completion. This enables workflows where a single photoshoot or video recording can be reused across multiple campaigns with different backgrounds.
For images: call POST /removebg with image URL, bg_image URL pointing to new background scene, and optional stroke_size and stroke_color to add borders. For videos: call POST /remove-background with video_url and bg_color or bg_image_url. Store the transaction_id, then poll until processing completes.
Image quality enhancement and restoration
When working with legacy content, low-resolution uploads, or thumbnails that need to be repurposed for print or large displays, the Picsart upscaling endpoints restore quality. POST /upscale handles quick 2-8x upscaling synchronously for most images. For extreme upscaling (up to 16x), POST /upscale/ultra with mode 'async' processes large images in the background and returns a transaction_id that can be polled via GET /upscale/ultra/{transaction_id}. This is ideal for AI agents restoring archival photos or preparing social media content for billboard printing.
For standard upscaling: call POST /upscale with image URL and upscale_factor (2, 4, 6, or 8). For extreme upscaling: call POST /upscale/ultra with image URL, upscale_factor up to 16, and mode 'async'. Capture the transaction_id from the 202 response, then poll GET /upscale/ultra/{transaction_id} every 10 seconds until status is 'success' and data.url is returned.
AI agent media processing via Jentic
An AI agent managing a content marketing platform uses Jentic to discover Picsart's image manipulation capabilities without reading documentation. The agent searches Jentic for 'remove background from product image', loads the background removal schema, executes POST /removebg with the product photo URL, then chains to 'upscale image to 4K' to load the upscaling schema and generate high-resolution output. Jentic stores the Picsart API key encrypted in its vault and injects it at execution time, so the agent never handles the raw credential. Rate limits and credit consumption are tracked in response headers, allowing the agent to throttle requests intelligently.
Search Jentic for 'remove image background', load the schema for removeBackground, execute it with image URL and desired bg_color. Capture the result URL, then search for 'upscale image', load upscaleImage schema, and execute with the cutout image URL and upscale_factor 4. Monitor X-Picsart-Credit-Available header to track remaining credits.
Key Endpoints
5 endpoints — jentic publishes the only available openapi specification for picsart enterprise api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/removebg
Remove or replace image background
POST
/upscale
Upscale image by 2-8x
POST
/upscale/ultra
Ultra upscale image by 2-16x with async support
GET
/upscale/ultra/{transaction_id}
Get ultra upscale result
POST
/remove-background
Remove or replace video background
POST
/removebg
Remove or replace image background
POST
/upscale
Upscale image by 2-8x
POST
/upscale/ultra
Ultra upscale image by 2-16x with async support
GET
/upscale/ultra/{transaction_id}
Get ultra upscale result
POST
/remove-background
Remove or replace video background
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Picsart Enterprise API by hand means setting up its API key in the Authorization header, choosing between the image and video hosts, and polling ultra-upscale transactions yourself. Through Jentic you install once, import Picsart from the API Directory, store the API key once, and your agent calls it.
Permission scoping
Picsart acts on the image you submit in the request body rather than a resource id in the URL, so scoping is by operation: you limit the agent to the operations it needs, such as background removal or standard upscale, and leave out ones like ultra upscale unless you add them.
Credential isolation
Your Picsart API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'remove the background from an image' or 'upscale a photo to 4K', and Jentic returns the matching Picsart operation with its request schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Picsart Enterprise API through Jentic.
Why is there no official OpenAPI spec for Picsart Enterprise API?
Picsart does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Picsart API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Picsart API use?
The Picsart API uses an API key passed in the Authorization header. When you call it through Jentic, the key is stored encrypted in the Jentic credential vault and injected at execution time, so the secret never enters the agent's prompt or logs.
What is the difference between standard and ultra upscaling?
Standard upscaling via POST /upscale supports 2x, 4x, 6x, and 8x factors and processes synchronously. Ultra upscaling via POST /upscale/ultra supports 2-16x factors and offers async, sync, or auto modes for handling larger images. Ultra mode is recommended for upscaling beyond 8x or for very large source images.
Can I process videos with the Picsart API?
Yes. Use POST /remove-background at the video API endpoint (https://video-api.picsart.io/v1) to remove or replace video backgrounds. Video processing is asynchronous - you receive a transaction_id and must poll for completion. Video upscaling is not currently supported in the API.
How do I track rate limits and credit usage?
Picsart returns rate limit information in response headers: X-Picsart-Ratelimit-Available (remaining calls), X-Picsart-Ratelimit-Limit (total limit), X-Picsart-Ratelimit-Reset-Time (when limit resets), and X-Picsart-Credit-Available (remaining credits). Monitor these headers to throttle requests before hitting limits.
What image formats does Picsart support?
Picsart accepts images as binary uploads or URLs in common formats (JPG, PNG, WEBP). Output can be specified as JPG, PNG, or WEBP using the 'format' parameter. PNG is recommended when you need transparency (e.g., cutouts without backgrounds).
Can I add borders or effects to cutout images?
Yes. When calling POST /removebg, you can specify stroke_size (border width), stroke_color (hex code), stroke_opacity (0-100), and shadow parameters to add visual effects to the cutout subject. This is useful for creating product images with subtle borders or drop shadows.
Can I limit what my agent is allowed to do with the Picsart Enterprise API?
Yes. Because Jentic One is self-hosted, you control which operations your agent can call, and your own rules decide that. Since Picsart acts on the image or video you submit in the request body rather than a resource in the URL, scoping is by operation: you can allow only what the agent needs, such as background removal via POST /removebg or standard upscaling via POST /upscale, and leave out others like ultra upscale via POST /upscale/ultra or video background removal via POST /remove-background. Your API key is stored encrypted by your own instance and injected at execution time, so the agent only ever exercises the operations you have granted.
GET STARTED