Export API - Polling

Learn how to track video export progress in the Picsart Create Editor using the Export API Polling method.

Suggest Edits

Once a video has been exported from the Picsart Create Editor a jobGuid is assigned to the expected result. This parameter is returned through the onExport Method from the Picsart Create Editor as taskId within the data result.

Since the rendering of the video is not immediate, an API call should be made using the taskId as a parameter to retrieve either the result or the progress of the rendering.

GET
query parameters

https://video-api.picsart.io/v1/renders/jobs?guid={jobGuid}

Possible responses

Rendering - in progress

{
   "jobs": [
       {
           "id": "{jobGuid}",
           "status": "rendering",
           "timeElapsed": 0.0,
           "timeEstimate": null,
           "progress": 33,
           "error": null,
           "result": ""
       }
   ]
}

Done - video ready

{
   "jobs": [
       {
           "id": "{jobGuid}",
           "status": "done",
           "timeElapsed": 0.0,
           "timeEstimate": null,
           "progress": 100,
           "error": null,
           "result": "https://{base_url}/{jobGuid}/output/{jobGuid}.mp4"
       }
   ]
}

Error during the rendering

{
   "jobs": [
       {
           "id": "{jobGuid}",
           "status": "error",
           "timeElapsed": 0.0,
           "timeEstimate": null,
           "progress": 5,
           "error": "Error message",
           "result": ""
       }
   ]
}

Storage

  • Uploaded files using the upload tool will be available for 7 days.
  • All rendered and input artifacts will be stored on an NFS file system for 12 hours.
  • All rendered files will be also saved on Picsart storages for 7 days.

Updated 3 months ago