skills.rest
PicsArt
PicsArtOFFICIAL
Explore all skills by this author →
WebsiteGitHub

picsart-api

Generate and edit images, videos, and audio via Picsart MCP API tools.

4|2|Updated May 6, 2026
Search Tags:#api#image generation#mcp#video editing#text-to-image#background removal#picsart
One-click install
npx skills add https://github.com/PicsArt/gen-ai-skills --skill picsart-api-picsart
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: picsart-api
Source: https://github.com/PicsArt/gen-ai-skills/tree/main/skills/picsart-api
Command: npx skills add https://github.com/PicsArt/gen-ai-skills --skill picsart-api-picsart

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Calling Picsart's four REST APIs (Image, Video, GenAI, Variable Data) requires knowing dozens of exact tool names, enum values, and async polling patterns. This Skill maps user intent to the correct MCP tool, enforces verbatim parameter usage, and chains submit calls with their paired pollers so jobs actually complete. ## Core Features & Use Cases - Four API surfaces in one entry point: Image editing (background removal, upscale, effects), Video editing (trim, crop, concat, transcribe), GenAI generation (text-to-image, text-to-video, speech, stickers, logos), and Variable Data bulk rendering from Replay templates. - Async job handling: Every submit tool is paired with its correct -getresult poller, with explicit rules to never declare success before a terminal status. - Intent disambiguation: Decision tables route similar requests (e.g. enhance vs. prompt-based edit, image vs. video background removal) to the right API surface. - Use Case: A user asks to remove the background from a product photo, upscale it 4x, then generate a 5-second promo video from the result — the Skill reads the relevant reference docs, calls image-remove-background, image-ultra-upscale with polling, then genai-image2video with polling, and returns the final URLs. ## Quick Start Ask the agent to remove the background from an image URL using the Picsart API and return the result URL.

Frequently Asked Questions about picsart-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an image from a text prompt with the Picsart API?▼

Call the genai-text2image MCP tool with a prompt, optional width, height, count, and model. It returns an inference_id, which you poll via genai-text2image-getresult until status is success, then return the image URLs.

How do I remove a background from an image or video using Picsart?▼

For a still image, call image-remove-background with an image or image_url; it is synchronous and returns a result URL. For video, call video-remove-background with a video_url, then poll video-getresult with the returned transaction_id.

What authentication does the Picsart MCP server require?▼

The picsart MCP server at https://mcp.picsart.io/v1 authenticates with an X-Picsart-API-Key header populated from the PICSART_API_KEY environment variable. A separate picsart-gen-ai server uses OAuth sign-in instead of an API key.

Why does my Picsart API call return a job id instead of a result?▼

Most generation and video tools are asynchronous and return an inference_id or transaction_id with a 202 status. You must call the paired getresult tool (for example genai-text2image-getresult or video-getresult) until the status is terminal before treating the task as done.

Can I use a local file with the Picsart MCP tools?▼

MCP tools accept files or URLs, but the server cannot read files from your local machine. Use the Picsart upload widget (picsart_upload_widget or mp_upload) to get a hosted URL first, then pass that URL to the target tool.

What are the limits of Picsart Variable Data bulk rendering?▼

The vd-export-variable-data-content tool processes only the first 50 data rows of the CSV, so larger batches must be split into multiple jobs. Outputs support PDF, PNG, JPG, MP4, and REPLAY formats, and each row consumes credits.

Related Skills

Explore More Design & Creative Skills→
Merit-SystemsMerit-Systems
16

upload-and-share

Uploads local files to StableUpload and retrieves public URLs for sharing via agentcash MCP.

Official
Intermediate
williamsforealwilliamsforeal
1

s3-uploader

Upload images or videos to S3/R2 and return canonical URLs for Airtable attachment fields.

Community
Basic
ZeroLuZeroLu
79

ultimate-ai-media-generator-skill

Automate image and video generation tasks via CyberBara API v1.

Community
Advanced
vellum-aivellum-ai
1.0k

mcp-setup

Configure MCP servers for adding, authenticating, listing, and removing external tools.

Official
Intermediate