Export API - Polling

Once a video has been exported from the Picsart Photo and Video Editor SDK a jobGuid is assigned to the expected result. This parameter is returned through the onExport Method from the Picsart Photo and Video Editor SDK 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.