Skip to main content
QwenCloud home page
Docs
VideoRetalk

VideoRetalk — Query the result

Poll a VideoRetalk task and retrieve the lip-synced video

GET
/tasks/{task_id}
cURL
# China North 2 (Beijing). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --request GET \
  --url https://cn-beijing.maas.qwencloudapi.com/api/v1/tasks/{task_id} \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "87b9dce5-7f36-4305-a347-xxxxxx",
  "output": {
    "task_id": "3afd65eb-9604-48ea-8a91-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-11 20:15:29.887",
    "scheduled_time": "2025-09-11 20:15:36.741",
    "end_time": "2025-09-11 20:16:40.577",
    "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "video_duration": 7.2,
    "size": "1080*1920",
    "video_ratio": "standard",
    "fps": 25
  }
}
Poll this operation with the task_id returned by Create a task. Keep polling until task_status is SUCCEEDED or FAILED. Supported regions: China North 2 (Beijing) only. Use an API key created in that region and the https://cn-beijing.maas.qwencloudapi.com endpoint. See Regions and endpoints.
The generated video URL is valid for 24 hours. Download the video promptly. Billing is based on the duration of the generated video.

Authorizations

​
string
header
required

QwenCloud API key. See API keys.

Path Parameters

​
string
required

The task_id returned when the task was submitted.

Response

200-application/json
​
string

Unique ID of the request.

​
object
​
object

Usage information returned when the task succeeds.