Interfaces

REST API

Every model runs as a workflow on the Picsart API gateway. Each of the 169 models maps to a workflow name (shown on its model page); you call that workflow synchronously or asynchronously. The SDK wraps all of this — use these endpoints when calling the API directly.

Base URL

https://api.picsart.com/gw-v2

Authentication

Requests are authenticated with your Picsart API key as a bearer token (see Authentication).

Authorization: Bearer <PICSART_API_KEY>

Execution modes

• Sync — POST /workflows/{workflow}/execute. Returns the result in one call. Use only when the task finishes within ~20s (fast image models); otherwise it times out.
• Async — POST /workflows/{workflow}/submit returns a task id, then poll GET /workflows/{workflow}/{id}/result. Use for video and other long-running jobs.

Sync request

Send the model's parameters wrapped in a params object. Per-model parameters are documented on each model page.

POST /workflows/flux-v2/execute HTTP/1.1
Host: api.picsart.com/gw-v2
Authorization: Bearer <PICSART_API_KEY>
Content-Type: application/json

{
  "params": {
    "prompt": "A serene mountain lake at golden hour",
    "model": "flux-2-pro"
  }
}

{
  "status": "success",
  "response": {
    "id": "wf_abc123",
    "status": "COMPLETED",
    "result": { "url": "https://cdn.picsart.com/…/result.png" },
    "usage": { "credits": 12 }
  }
}

Async: submit & poll

Submit returns a task id; poll the result until response.status is COMPLETED or FAILED.

{ "status": "success", "response": { "id": "wf_abc123" } }

GET /workflows/flux-v2/wf_abc123/result HTTP/1.1
Host: api.picsart.com/gw-v2
Authorization: Bearer <PICSART_API_KEY>

Response envelope

• status — request status (success).
• response.status — task status: ACCEPTED · IN_PROGRESS · COMPLETED · FAILED.
• response.result — the workflow output (e.g. a generated asset URL). Shape is model-specific.
• response.usage.credits — credits charged (see a model's Pricing tab).