AGTCloud API Docs
GuidesAPI ReferenceIntegrations and resourcesUpdate and help
Video generationPixVerse

PixVerse Retrieve video

Query the status and video result using the native task ID returned by creation.

GET/openapi/v2/video/result/{task_id}

Authorization

bearerAuth
AuthorizationBearer <token>

Use a platform API key in the format Authorization: Bearer your-api-key.

In: header

Path Parameters

task_id*string

Resp.video_id returned by creation. Preserve all digits; do not add a prefix.

Match^[0-9]+$

Header Parameters

Ai-trace-id?string

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.