Interfaces

REST API

Every model runs as a workflow on the Picsart API gateway. Each of the 234 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#

Production

https://api.picsart.com

Authentication#

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

Headers

Authorization: Bearer <PICSART_API_KEY>

Request headers
Name	Type	Description
`Authorization`required	Bearer <key>	Your Picsart API key as a bearer token.
`Content-Type`required	application/json	On every request with a body.

Execution modes#

Execution modes
Name	Type	Description
`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.

Request

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

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

Response

{
  "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.

Submit response

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

Poll result

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

Response envelope#

Response fields
Name	Type	Description
`status`	string	Request status (`success`).
`response.status`	string	Task status: `ACCEPTED` · `IN_PROGRESS` · `COMPLETED` · `FAILED`.
`response.result`	object	The workflow output (e.g. a generated asset URL). Shape is model-specific.
`response.usage.credits`	number	Credits charged (see a model's Overview tab).

Next steps#

Explore models →Find a model's workflow name and parameters.