Skip to main content
First & last frames

PixVerse -- retrieve keyframe-to-video result

Check PixVerse keyframe-to-video task status

GET
/tasks/{task_id}
cURL - Retrieve task result
# Replace {task_id} with the task ID returned by the create-task endpoint.
# Singapore (ap-southeast-1). This model is available only in this region.
curl -X GET 'https://ap-southeast-1.maas.qwencloudapi.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "7df19cf7-d76c-4bb8-b4c5-xxxxxxxxxxxx",
  "output": {
    "task_id": "5abf2c85-ea81-4cbf-8918-xxxxxxxxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-10-22 10:00:00.000",
    "scheduled_time": "2026-10-22 10:00:01.000",
    "end_time": "2026-10-22 10:02:30.000",
    "orig_prompt": "The flower bud slowly blooms, the petals open one by one.",
    "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxx/xxxx.mp4"
  },
  "usage": {
    "duration": 5,
    "size": "1280*720",
    "fps": 24,
    "video_count": 1,
    "audio": false,
    "SR": "720P"
  }
}
Poll task status and download the video when ready.

Polling strategy

  1. Save the task_id from the submit response.
  2. Poll this endpoint every 15 seconds until task_status is SUCCEEDED or FAILED.
  3. Download the video from output.video_url when the task succeeds.

Notes

  • Query window: task_id can be queried for 24 hours. After that, the status returns UNKNOWN.
  • Status flow: PENDING -> RUNNING -> SUCCEEDED or FAILED. CANCELED means the task was canceled.
  • Video URL: the link does not currently expire, but do not use it as long-term storage. Download the video promptly.

Authorizations

string
header
required

DashScope API Key. Get one from the QwenCloud console.

Path Parameters

string
required

Task ID returned by the create-task endpoint. Queryable for 24 hours.

Response

200-application/json
string

Unique request ID, useful for tracing and troubleshooting.

object

Task output.

object

Output statistics. Counted only for successful results.