canonical: https://jentic.com/apis/picsart.io/picsart

# Picsart Enterprise API

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.

## For AI 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.

## Scope

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.

## Capabilities

- 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

### 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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.

Example prompt: 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

| 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 |

## Key resources

- **Background Removal** — Remove and replace backgrounds from images and videos with AI-powered segmentation
- **Image Upscaling** — Enhance image resolution from 2x to 16x with standard and ultra upscaling modes

## Why Jentic

- **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 handling:** 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.
- **Discovery method:** 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

- **Remove.bg API** — Specialized background removal API with high-quality results for photos and products
- **Cloudinary API** — Media management platform with transformation, optimization, and delivery CDN
- **DeepAI API** — AI-powered image generation, style transfer, and enhancement tools

## FAQ

### 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.