Picsart GenAI

Official14 toolsLive

by api

Generate and edit images, videos, and audio with 100+ Picsart AI models.

Captured live from the server via tools/list.

picsart_cinema_studio

Opens the Picsart Cinema Studio: build a longer video as a sequence of Shots in a video-player UI. Pick one model per film (Seedance or Kling), generate each Shot (capped at the model max duration), optionally continue a shot from the previous shot's last frame, and save the film into a "Cinema Studio" folder in the user's Picsart Drive. Use when the user wants to MAKE a longer video, a multi-shot clip, or a short film. Takes no input. Returns `{ items, total, truncated }` — the curated Seedance+Kling catalog with per-model capabilities the widget renders. Read-only; no credits, no auth.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_drive

Single entry point for the authenticated user's Picsart Drive. Pass `action`: - `list`: browse a folder. `folderUid` omitted = Drive root; set it to descend. Folders are returned first; files are paginated (`page`, `pageSize`<=128, optional `sort`, optional `type` filter). Set `flat: true` to list every file across all folders (folders are omitted in flat mode). - `create_folder`: requires `name`; `folderUid` = parent (omit for root). Optional `description`. - `upload`: save a file. Provide EITHER `file` (chat attachment) OR `url`+`name` (an HTTPS URL or an inline `data:` URI — data URIs are pushed to the Picsart CDN first). `folderUid` = destination, `type` = resource kind. `result.url` is the CDN-hosted URL of the saved file, ready to pass to `picsart_generate` reference params like `imageUrls`. - `move`: requires `itemUids`; `targetFolderUid` = destination (omit = root). - `delete`: requires `itemUids`; soft-deletes to trash unless `permanent` is true. - `update`: requires `itemUid` + `attributes`; sets custom key/value attributes on a file (e.g. `{ coverUrl }`). Every action returns the current folder listing (folders, files, page math) so the widget can render. Requires Authorization: Bearer <picsart_token> (per-user Drive content).

Parameters16

action	string	required
folderUid	string	optional
page	integer	optional
pageSize	integer	optional
sort	object	optional
type	string	optional
flat	boolean	optional	List action: when true, returns every file across the whole Drive (all folders) instead of just the items directly inside `folderUid`. Folders are not returned in flat mode.
name	string	optional
description	string	optional
file	object	optional
url	string	optional
itemUids	array	optional
itemUid	string	optional	Update action: uid of the file whose attributes to set.
attributes	object	optional	Update action: custom key/value attributes to set on the file (e.g. `{ coverUrl }`).
targetFolderUid	string	optional
permanent	boolean	optional	Delete action: true permanently purges; false/omitted moves to trash (recoverable).

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "list",
        "create_folder",
        "upload",
        "move",
        "delete",
        "update"
      ]
    },
    "folderUid": {
      "type": "string"
    },
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "pageSize": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 128
    },
    "sort": {
      "type": "object",
      "properties": {
        "by": {
          "type": "string",
          "enum": [
            "CREATED",
            "UPDATED",
            "ALPHABETICAL"
          ]
        },
        "order": {
          "type": "string",
          "enum": [
            "ASC",
            "DESC"
          ]
        }
      },
      "required": [
        "by",
        "order"
      ],
      "additionalProperties": false
    },
    "type": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ]
    },
    "flat": {
      "type": "boolean",
      "description": "List action: when true, returns every file across the whole Drive (all folders) instead of just the items directly inside `folderUid`. Folders are not returned in flat mode."
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "file": {
      "type": "object",
      "properties": {
        "download_url": {
          "type": "string",
          "format": "uri"
        },
        "file_id": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "file_name": {
          "type": "string"
        }
      },
      "required": [
        "download_url",
        "file_id"
      ],
      "additionalProperties": false
    },
    "url": {
      "type": "string",
      "format": "uri"
    },
    "itemUids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 200
    },
    "itemUid": {
      "type": "string",
      "description": "Update action: uid of the file whose attributes to set."
    },
    "attributes": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Update action: custom key/value attributes to set on the file (e.g. `{ coverUrl }`)."
    },
    "targetFolderUid": {
      "type": "string"
    },
    "permanent": {
      "type": "boolean",
      "description": "Delete action: true permanently purges; false/omitted moves to trash (recoverable)."
    }
  },
  "required": [
    "action"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_remove_bg

Removes the background from an image, returning a transparent cutout of the foreground subject. Auto-picks the newest enabled Picsart remove-bg model unless overridden via the `model` param — no need to call `picsart_list_models` first. Use this when the user asks to "remove the background", "cut out the subject", or "make the background transparent". Do NOT use this to replace the background with a new scene (use `picsart_change_bg`), upscale or sharpen the result (use `picsart_enhance`), convert raster to SVG (use `picsart_vectorize`), or generate a new image from scratch (use `picsart_generate`). Required input: `image` — a publicly-accessible URL. Local files are not supported; if you only have a local file, first make it available as a public or app-authorized URL. Optional: `model` to pin a specific remove-bg model, `outputFormat` (e.g. "png"). Example: `{ image: "https://example.com/portrait.jpg" }`. Returns `{ assets, id, model, created_at, summary, why_relevant, url, results: [{ url, metadata? }], drive? }` plus a `resource_link` block per result URL. `id` is the SDK's generation handle; `metadata` may include model-specific tags. Spends credits. Requires Authorization: Bearer <picsart_token>.

Parameters3

image	string	required	Input image URL
model	string	optional	Override model ID (e.g. "picsart-remove-bg")
outputFormat	string	optional	Output format (e.g. "png")

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Input image URL"
    },
    "model": {
      "type": "string",
      "description": "Override model ID (e.g. \"picsart-remove-bg\")"
    },
    "outputFormat": {
      "type": "string",
      "description": "Output format (e.g. \"png\")"
    }
  },
  "required": [
    "image"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_change_bg

Replaces the background of an image with a new scene described by a prompt, keeping the foreground subject intact. Auto-picks the newest enabled Picsart change-bg model unless overridden via the `model` param — no need to call `picsart_list_models` first. Use this when the user wants to "change the background to X", "put this on a beach", "swap the background for a marble counter", or any compositing where the subject is kept and the backdrop changes. Do NOT use this to strip the background to transparency (use `picsart_remove_bg`), upscale or sharpen (use `picsart_enhance`), convert raster to SVG (use `picsart_vectorize`), or generate a brand-new image from scratch (use `picsart_generate`). Required inputs: `image` — a publicly-accessible URL, not a local file path — and `prompt` describing the new background. Optional: `model` to pin a specific change-bg model. Example: `{ image: "https://example.com/product.jpg", prompt: "polished marble countertop with soft window light" }`. Returns `{ assets, id, model, created_at, prompt, summary, why_relevant, url, results: [{ url, metadata? }], drive? }` plus a `resource_link` block per result URL. `id` is the SDK's generation handle; `metadata` may include model-specific tags (e.g. `exploreImageId` for Recraft Explore models). Spends credits. Requires Authorization: Bearer <picsart_token>.

Parameters3

image	string	required	Input image URL
prompt	string	required	Description of the new background
model	string	optional	Override model ID

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Input image URL"
    },
    "prompt": {
      "type": "string",
      "description": "Description of the new background"
    },
    "model": {
      "type": "string",
      "description": "Override model ID"
    }
  },
  "required": [
    "image",
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_enhance

Upscales and enhances an image — sharpens edges, denoises, and raises resolution by an optional scale factor. Auto-picks the newest enabled Picsart upscale / enhance model unless overridden via the `model` param. Use this when the user asks to "upscale", "enhance", "make it higher resolution", "sharpen", "clean up this photo", or "make this 4k". Do NOT use this to remove the background (use `picsart_remove_bg`), replace the background (use `picsart_change_bg`), convert raster to SVG (use `picsart_vectorize`), or generate a new image (use `picsart_generate`). Required input: `image` — a publicly-accessible URL, not a local file path. Optional: `model` to pin a specific enhance model, `scaleFactor` (e.g. 2 or 4) for upscale ratio. Example: `{ image: "https://example.com/photo.jpg", scaleFactor: 4 }`. Returns `{ assets, id, model, created_at, summary, why_relevant, url, results: [{ url, metadata? }], drive? }` plus a `resource_link` block per result URL. `id` is the SDK's generation handle; `metadata` may include model-specific tags. Spends credits. Requires Authorization: Bearer <picsart_token>.

Parameters3

image	string	required	Input image URL
model	string	optional	Override model ID (e.g. "picsart-enhance")
scaleFactor	number	optional	Upscale factor (e.g. 2, 4)

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Input image URL"
    },
    "model": {
      "type": "string",
      "description": "Override model ID (e.g. \"picsart-enhance\")"
    },
    "scaleFactor": {
      "type": "number",
      "description": "Upscale factor (e.g. 2, 4)"
    }
  },
  "required": [
    "image"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_vectorize

Converts a raster image (PNG, JPG) into an SVG vector. Auto-picks the newest enabled Picsart vectorize model unless overridden via the `model` param. Use this when the user asks to "vectorize", "convert to SVG", "make this a vector", or wants a scalable version of a logo or icon. Best results on logos, icons, and simple graphics — photographic images vectorize poorly and the user should be warned. Do NOT use this to remove the background (use `picsart_remove_bg`), replace the background (use `picsart_change_bg`), upscale a raster image (use `picsart_enhance`), or generate a new image (use `picsart_generate`). Required input: `image` — a publicly-accessible URL to a PNG or JPG (not a local file path). Optional: `model` to pin a specific vectorize model. Example: `{ image: "https://example.com/logo.png" }`. Returns `{ assets, id, model, created_at, summary, why_relevant, url, results: [{ url, metadata? }], drive? }` plus a `resource_link` block for the SVG URL (mime `image/svg+xml`). `id` is the SDK's generation handle. Clients fetch the SVG from that URL. Spends credits. Requires Authorization: Bearer <picsart_token>.

Parameters2

image	string	required	Input image URL
model	string	optional	Override model ID

Raw schema

{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "description": "Input image URL"
    },
    "model": {
      "type": "string",
      "description": "Override model ID"
    }
  },
  "required": [
    "image"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_generate

Runs any Picsart AI model end-to-end to produce an image, video, or audio result. Spends credits. Recommended flow: `picsart_list_models` to pick the model → `picsart_model_params` to learn its inputs → `picsart_preflight` to validate the payload and quote cost → `picsart_generate` to actually run. Do NOT use this for editing operations that have dedicated tools — background removal (`picsart_remove_bg`), background replacement (`picsart_change_bg`), upscale / enhancement (`picsart_enhance`), or raster-to-SVG conversion (`picsart_vectorize`). Also do NOT use it to validate params, quote cost, or browse the catalog — those are separate tools above. Required inputs: `model` (id) and `prompt`. Model-dependent optional inputs: `duration` (video seconds), `aspectRatio` (e.g. "16:9", "9:16", "1:1"), `resolution` (e.g. "1080p", "4k"), `count` (1–8 outputs), `quality`, `style`, `negativePrompt`, `imageUrls` (for image-to-X models), `videoUrl` (for video-to-X), `enhancePrompt`, `generateAudio`, and `extra` — a free-form record for model-specific params (discover them via `picsart_model_params`). Example (image): `{ model: "flux-2-pro", prompt: "a cat in a hat", aspectRatio: "16:9", count: 1 }`. Example (video): `{ model: "kling-v3-pro", prompt: "a cat skiing down a mountain", duration: 5, aspectRatio: "16:9" }`. Returns `{ assets, id, model, created_at, prompt, summary, why_relevant, url, results: [{ url, metadata? }], drive? }` in structured content, plus one `resource_link` block per result URL — image models emit image links, video models emit video links (mime `video/mp4`). `id` is the SDK's generation handle; `metadata` may include model-specific tags (e.g. `exploreImageId` for Recraft Explore models). ChatGPT renders images and videos with the Picsart media gallery UI; clients fetch the assets from URLs, never base64. Spends credits and writes to the user's Picsart Drive when the Drive option is enabled. Requires Authorization: Bearer <picsart_token>.

Parameters16

model	string	required	Model ID (e.g. "flux-2-pro", "kling-v3-pro")
prompt	string	required	Generation prompt
duration	number	optional	Video duration in seconds
aspectRatio	string	optional	Aspect ratio (e.g. "16:9", "9:16", "1:1")
resolution	string	optional	Resolution (e.g. "1080p", "4k")
count	integer	optional	Number of outputs
quality	string	optional	Quality preset
style	string	optional	Style preset
negativePrompt	string	optional	What to avoid
imageUrls	array	optional	Input images for image-to-X models
videoUrl	string	optional	Input video for video-to-X models
enhancePrompt	boolean	optional	AI-enhance the prompt before generating
generateAudio	boolean	optional	Generate audio track for video
saveToDrive	boolean	optional	Auto-save the result into the user's Drive (default true). Set false when the caller persists the result itself (e.g. Music Studio saves into its own folder) to avoid a duplicate copy.
async	boolean	optional	Submit the job and return immediately with `{ job, status: "ACCEPTED" }` instead of waiting for the result. Meant for widget code that polls `picsart_job_status` with the returned handle; assistants should omit it and wait for the synchronous result.
extra	object	optional	Extra model-specific params. The accepted shape varies per model — picsart_model_params returns the JSON schema for any model, and picsart_preflight can pre-check (and price) a candidate object before generation.

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model ID (e.g. \"flux-2-pro\", \"kling-v3-pro\")"
    },
    "prompt": {
      "type": "string",
      "description": "Generation prompt"
    },
    "duration": {
      "type": "number",
      "description": "Video duration in seconds"
    },
    "aspectRatio": {
      "type": "string",
      "description": "Aspect ratio (e.g. \"16:9\", \"9:16\", \"1:1\")"
    },
    "resolution": {
      "type": "string",
      "description": "Resolution (e.g. \"1080p\", \"4k\")"
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "description": "Number of outputs"
    },
    "quality": {
      "type": "string",
      "description": "Quality preset"
    },
    "style": {
      "type": "string",
      "description": "Style preset"
    },
    "negativePrompt": {
      "type": "string",
      "description": "What to avoid"
    },
    "imageUrls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Input images for image-to-X models"
    },
    "videoUrl": {
      "type": "string",
      "description": "Input video for video-to-X models"
    },
    "enhancePrompt": {
      "type": "boolean",
      "description": "AI-enhance the prompt before generating"
    },
    "generateAudio": {
      "type": "boolean",
      "description": "Generate audio track for video"
    },
    "saveToDrive": {
      "type": "boolean",
      "description": "Auto-save the result into the user's Drive (default true). Set false when the caller persists the result itself (e.g. Music Studio saves into its own folder) to avoid a duplicate copy."
    },
    "async": {
      "type": "boolean",
      "description": "Submit the job and return immediately with `{ job, status: \"ACCEPTED\" }` instead of waiting for the result. Meant for widget code that polls `picsart_job_status` with the returned handle; assistants should omit it and wait for the synchronous result."
    },
    "extra": {
      "type": "object",
      "additionalProperties": {},
      "description": "Extra model-specific params. The accepted shape varies per model — picsart_model_params returns the JSON schema for any model, and picsart_preflight can pre-check (and price) a candidate object before generation."
    }
  },
  "required": [
    "model",
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_job_status

Checks a generation job started by `picsart_generate` with `async: true`. Widget-facing: widgets poll this every few seconds with the returned job handle; assistants normally call `picsart_generate` synchronously and never need this tool. While running it returns `{ status: "ACCEPTED"|"IN_PROGRESS", progress?: { percent, estimatedSecondsLeft } }`. Once finished it returns the same media payload `picsart_generate` would have returned (`{ status: "COMPLETED", assets, results, url, ... }`), or an error for FAILED/CANCELED jobs. Requires Authorization: Bearer <picsart_token>.

Parameters4

job	object	required	The job handle returned by `picsart_generate` when called with `async: true`.
model	string	required	Model ID the job was submitted with (e.g. "seedance-2.0")
prompt	string	optional	Original prompt — echoed into the completed result metadata
saveToDrive	boolean	optional	Mirror of the original call's saveToDrive flag; pass false when the caller persists the result itself.

Raw schema

{
  "type": "object",
  "properties": {
    "job": {
      "type": "object",
      "properties": {
        "workflow": {
          "type": "string",
          "description": "Workflow name from the job handle"
        },
        "id": {
          "type": "string",
          "description": "Job id from the job handle"
        }
      },
      "required": [
        "workflow",
        "id"
      ],
      "additionalProperties": false,
      "description": "The job handle returned by `picsart_generate` when called with `async: true`."
    },
    "model": {
      "type": "string",
      "description": "Model ID the job was submitted with (e.g. \"seedance-2.0\")"
    },
    "prompt": {
      "type": "string",
      "description": "Original prompt — echoed into the completed result metadata"
    },
    "saveToDrive": {
      "type": "boolean",
      "description": "Mirror of the original call's saveToDrive flag; pass false when the caller persists the result itself."
    }
  },
  "required": [
    "job",
    "model"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_list_models

Lists Picsart AI models across ALL modes (image / video / audio) and renders the Picsart Studio model-picker widget so the USER can browse, compare, and pick a model visually. Each item carries `id`, `name`, `mode`, `inputType` (and `provider`, `badges`, `description` when `verbose` is true). Use this when the user wants to SEE the available models or pick one themselves — especially when they have not committed to an output mode yet, or for cross-mode searches ("all flux models", "every model with image input"). For known output modes prefer the dedicated tools — `picsart_list_image_models`, `picsart_list_video_models`, `picsart_list_audio_models` — they route better from implicit prompts and need fewer filters. Do NOT use it to fetch a single model's parameter schema (use `picsart_model_params`) or estimate per-call cost (use `picsart_preflight`). If you only need catalog knowledge for your own reasoning (no UI shown to the user), use `picsart_model_catalog` instead. Inputs (all optional): `mode` (filter to image/video/audio), `provider` (case-insensitive substring like "flux", "kling", "google"), `acceptsImage` (true → only models that take an image input — i2i, i2v), `acceptsVideo` (true → only models that take a video input — v2v, v2a), `acceptsAudio` (true → only models that take an audio input — a2v, sts), `inputType` (exact-match escape hatch; one of t2v/i2v/v2v/a2v/t2i/i2i/t2a/v2a/tts/sts/sfx/music), `limit` (1–100, default 20), `verbose` (default false; when true each item adds provider/badges/description). inputType codes — first letter is input modality, second is output: t2i (text→image), i2i (image→image), t2v (text→video), i2v (image→video), v2v (video→video), a2v (audio→video), t2a (text→audio), v2a (video→audio), tts (text-to-speech), sts (speech-to-speech), sfx (sound effects), music (music gen). Example: `{ mode: "video", acceptsImage: true, limit: 10 }` returns image-to-video models. Returns `{ items, total, truncated }` — `truncated` is true when more matched than were returned; refine filters or raise `limit` (max 100) to see more. Read-only; spends no credits and works without authentication.

Parameters8

mode	string	optional	Filter by generation mode
provider	string	optional	Provider substring (e.g. "kling", "flux", "google")
acceptsImage	boolean	optional	Only return models that accept an image input (i2i, i2v)
acceptsVideo	boolean	optional	Only return models that accept a video input (v2v, v2a)
acceptsAudio	boolean	optional	Only return models that accept an audio input (a2v, sts)
inputType	string	optional	Exact inputType match (e.g. "i2v")
limit	integer	optional	Max items to return (1–100, default 20)
verbose	boolean	optional	When true, include provider/badges/description per item. Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ],
      "description": "Filter by generation mode"
    },
    "provider": {
      "type": "string",
      "description": "Provider substring (e.g. \"kling\", \"flux\", \"google\")"
    },
    "acceptsImage": {
      "type": "boolean",
      "description": "Only return models that accept an image input (i2i, i2v)"
    },
    "acceptsVideo": {
      "type": "boolean",
      "description": "Only return models that accept a video input (v2v, v2a)"
    },
    "acceptsAudio": {
      "type": "boolean",
      "description": "Only return models that accept an audio input (a2v, sts)"
    },
    "inputType": {
      "type": "string",
      "enum": [
        "t2v",
        "i2v",
        "v2v",
        "a2v",
        "t2i",
        "i2i",
        "t2a",
        "v2a",
        "tts",
        "sts",
        "sfx",
        "music"
      ],
      "description": "Exact inputType match (e.g. \"i2v\")"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max items to return (1–100, default 20)"
    },
    "verbose": {
      "type": "boolean",
      "description": "When true, include provider/badges/description per item. Default false."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_model_catalog

Returns the Picsart AI model catalog as plain data — renders NO widget or UI. Use this when YOU (the assistant) need catalog knowledge for your own reasoning: picking a model before `picsart_generate`, answering "which models support X", or comparing options — without pushing a model-picker widget into the conversation. When the user wants to SEE or browse models visually, use `picsart_list_models` instead (it renders the Picsart Studio picker). Same filters and result shape as `picsart_list_models`, but every item is rich by default: `id`, `name`, `mode`, `inputType`, `provider`, `badges`, `description`. Do NOT use it to fetch a single model's parameter schema (use `picsart_model_params`) or estimate per-call cost (use `picsart_preflight`). Inputs (all optional): `mode` (filter to image/video/audio), `provider` (case-insensitive substring like "flux", "kling", "google"), `acceptsImage` (true → only models that take an image input — i2i, i2v), `acceptsVideo` (true → only models that take a video input — v2v, v2a), `acceptsAudio` (true → only models that take an audio input — a2v, sts), `inputType` (exact-match escape hatch; one of t2v/i2v/v2v/a2v/t2i/i2i/t2a/v2a/tts/sts/sfx/music), `limit` (1–100, default 20), `concise` (default false; when true items carry only id/name/mode/inputType to save tokens). inputType codes — first letter is input modality, second is output: t2i (text→image), i2i (image→image), t2v (text→video), i2v (image→video), v2v (video→video), a2v (audio→video), t2a (text→audio), v2a (video→audio), tts (text-to-speech), sts (speech-to-speech), sfx (sound effects), music (music gen). Example: `{ mode: "audio", inputType: "music" }` returns music-generation models. Returns `{ items, total, truncated }` — `truncated` is true when more matched than were returned; refine filters or raise `limit` (max 100) to see more. Read-only; spends no credits and works without authentication.

Parameters8

mode	string	optional	Filter by generation mode
provider	string	optional	Provider substring (e.g. "kling", "flux", "google")
acceptsImage	boolean	optional	Only return models that accept an image input (i2i, i2v)
acceptsVideo	boolean	optional	Only return models that accept a video input (v2v, v2a)
acceptsAudio	boolean	optional	Only return models that accept an audio input (a2v, sts)
inputType	string	optional	Exact inputType match (e.g. "i2v")
limit	integer	optional	Max items to return (1–100, default 20)
concise	boolean	optional	When true, items carry only id/name/mode/inputType. Default false (rich items).

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "image",
        "video",
        "audio"
      ],
      "description": "Filter by generation mode"
    },
    "provider": {
      "type": "string",
      "description": "Provider substring (e.g. \"kling\", \"flux\", \"google\")"
    },
    "acceptsImage": {
      "type": "boolean",
      "description": "Only return models that accept an image input (i2i, i2v)"
    },
    "acceptsVideo": {
      "type": "boolean",
      "description": "Only return models that accept a video input (v2v, v2a)"
    },
    "acceptsAudio": {
      "type": "boolean",
      "description": "Only return models that accept an audio input (a2v, sts)"
    },
    "inputType": {
      "type": "string",
      "enum": [
        "t2v",
        "i2v",
        "v2v",
        "a2v",
        "t2i",
        "i2i",
        "t2a",
        "v2a",
        "tts",
        "sts",
        "sfx",
        "music"
      ],
      "description": "Exact inputType match (e.g. \"i2v\")"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max items to return (1–100, default 20)"
    },
    "concise": {
      "type": "boolean",
      "description": "When true, items carry only id/name/mode/inputType. Default false (rich items)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_model_params

Returns the parameter schema for a specific Picsart model — a map of param name to descriptor ({ type, required, default, enum, min, max, step, label, accept }). Use this once you have a model id and need to construct the params payload for `picsart_generate` or feed `picsart_preflight` with a candidate object. Do NOT use it to discover which models exist (use `picsart_list_models`) or estimate cost (use `picsart_preflight`). Required input: `model` id. Example: `{ model: "flux-2-pro" }`. Returns `{ model, schema: { <paramName>: { type: "string"|"number"|"boolean"|"file", required?, default?, enum?, min?, max?, step?, label?, accept? } } }`. Read-only; spends no credits and works without authentication.

Parameters1

model

string

required

Model ID (e.g. "flux-2-pro")

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model ID (e.g. \"flux-2-pro\")"
    }
  },
  "required": [
    "model"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_preflight

Free pre-flight check before `picsart_generate`: in ONE call it (1) validates a candidate params object against the model's parameter schema + inter-parameter constraints, and (2) quotes the credit cost — without running the model or charging the user. Use this after assembling params (user input, derived defaults, model swaps) and before generating, to surface bad arguments and show cost. Do NOT use it to look up which params a model accepts (use `picsart_model_params`) or to actually generate (use `picsart_generate`). Required inputs: `model` id and a `params` object (put the `prompt` inside `params`). Example: `{ model: "flux-2-pro", params: { prompt: "a cat in a hat", aspectRatio: "16:9", count: 1 } }`. Returns `{ model, valid, errors?, credits }`: `valid`/`errors` are from local validation (always present, no auth needed; `errors` only when invalid); `credits` is the dry-run cost (a number), or `null` when pricing is unavailable or the request is unauthenticated.

Parameters2

model	string	required	Model ID
params	object	required	Candidate params (include the prompt). Validated locally and priced.

Raw schema

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "Model ID"
    },
    "params": {
      "type": "object",
      "additionalProperties": {},
      "description": "Candidate params (include the prompt). Validated locally and priced."
    }
  },
  "required": [
    "model",
    "params"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_credits

Returns the current Picsart credit balance for the authenticated user — `balance` (active credits available now) plus the breakdown into `resettable` (recurring monthly/period quota) and `accumulative` (top-ups and add-ons), `total` (active credits across both pools), and `overdraftUsage` (credits spent past the balance, if any). When the resettable pool has a scheduled reset, `nextResetDate` is the ISO timestamp of the next refill. Use this before expensive operations to warn the user when the balance is low, or after a 402 from `picsart_generate` to confirm the issue is credits and not something else. Do NOT use it to estimate the cost of a specific generation (use `picsart_preflight`); this tool only reports the balance, not per-call cost. Takes no input. Returns `{ balance, total, resettable, accumulative, overdraftUsage, nextResetDate? }` where each number is non-negative. Requires Authorization: Bearer <picsart_token> (per-user account data).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

picsart_music_studio

Opens the Picsart Music Studio: browse music/audio models, compose with a guided prompt builder, generate and play tracks, create AI album-cover art, revisit previously generated tracks, and save everything into a "Music Studio" folder in the user's Picsart Drive. Use when the user wants to MAKE music, a song, a soundtrack, a jingle, or sound effects. Covers text-to-music (MiniMax Music v2, Google Lyria 3 Pro/Clip), short audio clips (Kling T2A), and sound effects (ElevenLabs SFX). Does NOT edit existing audio (no trimming, remixing, or stem work), and is not for text-to-speech / voice cloning or image/video generation. Takes no input. Returns `{ items, total, truncated }` — the curated music catalog the widget renders. Read-only; spends no credits and works without authentication.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (14)

picsart_cinema_studiopicsart_drivepicsart_remove_bgpicsart_change_bgpicsart_enhancepicsart_vectorizepicsart_generatepicsart_job_status

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.picsart.com/gen-ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gen-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.picsart.com/gen-ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.