A synchronous request returns its result in one response. An asynchronous request returns a job ID that you use to retrieve the result.
Choose an execution mode
Use synchronous execution for a short task. Use asynchronous execution for video or another task that can exceed the synchronous timeout.
The REST reference describes the current timeout and endpoints.
Track an asynchronous job
- Submit the request to the documented workflow endpoint.
- Save the returned job ID.
- Poll the result endpoint with that ID.
- Read the task status.
- Retrieve the output after the status becomes
COMPLETED.
If the status is FAILED, inspect the error before you submit another request. A timeout alone does not prove that processing failed.
Use the SDK
The SDK can handle result retrieval for you. Its submission and subscription methods also support tasks that need progress control.
See the quickstart and video guide. Do not assume webhook support from an older API applies to every current model.
Need help?
Contact Picsart Support with the subject What is the difference between synchronous and asynchronous API requests? - Help Center. Please include:
- The model, endpoint, or tool name.
- The date, approximate time, and time zone.
- The error message and request or job ID, if available.
- The expected result and the actual result.
Remove private data from screenshots and logs. Do not send API keys, passwords, access tokens, or private file URLs.