Picsart API Platform
← All models

Picsart Effects

New

Picsart · Image · Image → Image

Apply curated Picsart effect presets to a photo — multi-step Magic Flow pipelines, one tap.

Model ID: picsart-flowWorkflow: picsart-flow/v1/effects
Effect PresetsImage Required
Try on Playground ↗

Install the SDK

The SDK targets Node 20+ and ships with TypeScript types.

npm
npm install @picsart/ai-sdk

Authenticate

Create a client once with your API key — it's sent as a bearer token on every request.

TypeScript
import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY, // sent as: Authorization: Bearer <key>
  apiUrl: 'https://api.picsart.com',
});

Run the model

Call the model with its parameters. This example uses the required ones.

TypeScript
import { createClient } from '@picsart/ai-sdk';

const ai = createClient({
  apiKey: process.env.PICSART_API_KEY,
  apiUrl: 'https://api.picsart.com',
});

const result = await ai.generate('picsart-flow', {
  templateId: "",
  imageUrls: [
    "https://cdn.example.com/input.jpg"
  ]
});

console.log(result.url); // image URL

Parameters

2 parameters. Required ones must be supplied; the rest fall back to their defaults. The API takes these same names over HTTP.

ParameterTypeRequiredDefaultDetails
templateId
Effect Preset
catalogyesoptions from picsart-flow/v1/catalog/templates (picsart-flow)
imageUrls
Your Photo
file (image[])yes

Output

generate() resolves once the job completes. One or more image URLs.

Result
{
  "url": "https://cdn.picsart.com/…/result",
  "results": [
    {
      "url": "https://cdn.picsart.com/…/result"
    }
  ],
  "model": "picsart-flow"
}