Query Task Status
GET
/openapi/v2/video/result/{video_id}
video_id. Use this endpoint to poll the task status and retrieve the output URL after generation completes.Status Values
| status | Description |
|---|---|
1 | Generation completed. The output URL is available in Resp.url. |
5 | Generating. Continue polling every 3-5 seconds. |
7 | Content moderation failed. Review the request content before retrying. |
8 | Generation failed |
Polling Guidance
status=5.status=1 and Resp.url is accessible.status=7, revise content that may have failed moderation before creating a new request.status=8, inspect the request, preserve the Ai-trace-id, and verify any applicable credit refund in the account ledger.Request
Path Params
Header Params
Responses
Request Request Example
Shell
curl --location 'https://app-api.pixverse.ai/openapi/v2/video/result/' \
--header 'API-KEY: your-api-key' \
--header 'Ai-trace-id: 550e8400-e29b-41d4-a716-446655440000'Response Response Example
200 - Processing task
{
"ErrCode": 0,
"ErrMsg": "Success",
"Resp": {
"id": 123456789,
"status": 5,
"url": "",
"outputWidth": 0,
"outputHeight": 0
}
}