picsart_generate
ActiveTool of Picsart GenAI
Runs any Picsart AI model end-to-end to produce an image, video, audio, or text 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). Text/LLM models (mode "text" in the catalog — e.g. gemini-3-pro, gpt-5.5, claude-*) run synchronously (`async` is ignored) and return the generated text as the text content block plus `text` in structured content. 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>.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"model",
"prompt"
],
"properties": {
"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."
},
"count": {
"type": "integer",
"maximum": 8,
"minimum": 1,
"description": "Number of outputs"
},
"extra": {
"type": "object",
"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.",
"additionalProperties": {}
},
"model": {
"type": "string",
"description": "Model ID (e.g. \"flux-2-pro\", \"kling-v3-pro\")"
},
"style": {
"type": "string",
"description": "Style preset"
},
"prompt": {
"type": "string",
"description": "Generation prompt"
},
"quality": {
"type": "string",
"description": "Quality preset"
},
"duration": {
"type": "number",
"description": "Video duration in seconds"
},
"videoUrl": {
"type": "string",
"description": "Input video for video-to-X models"
},
"imageUrls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Input images for image-to-X models"
},
"resolution": {
"type": "string",
"description": "Resolution (e.g. \"1080p\", \"4k\")"
},
"aspectRatio": {
"type": "string",
"description": "Aspect ratio (e.g. \"16:9\", \"9:16\", \"1:1\")"
},
"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."
},
"enhancePrompt": {
"type": "boolean",
"description": "AI-enhance the prompt before generating"
},
"generateAudio": {
"type": "boolean",
"description": "Generate audio track for video"
},
"negativePrompt": {
"type": "string",
"description": "What to avoid"
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Picsart GenAI
1/7 registries