PixVerse Retrieve video
Query the status and video result using the native task ID returned by creation.
/openapi/v2/video/result/{task_id}Authorization
bearerAuth Use a platform API key in the format Authorization: Bearer your-api-key.
In: header
Path Parameters
Resp.video_id returned by creation. Preserve all digits; do not add a prefix.
^[0-9]+$Header Parameters
Optional unique trace value; generated by the platform if omitted. Not an idempotency key.
Response Body
application/json
application/json
application/json
application/json
Read the task status
HTTP 200 only means the query received a response. Check ErrCode, then Resp.status. 5 means processing: query every 3–5 seconds. 1 means success: read the video URL from Resp.url. 7 means moderation failed and 8 means generation failed; stop polling in both cases.
Preserve the complete native task ID. Do not immediately create another task just because generation is taking longer. Download or transfer the video promptly after success.
PixVerse retrieve video — official documentationView the corresponding upstream protocol definition.