跳转到主要内容
视频生成

灵动人像 LivePortrait — 查询视频生成结果

查询灵动人像 LivePortrait 视频生成任务状态,获取生成的视频

GET
/tasks/{task_id}
cURL
curl --location 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "b64e9c68-3923-462d-b25a-xxxxxx",
  "output": {
    "task_id": "a1c69ca5-810b-49ae-8b20-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-12-26 11:33:03.146",
    "scheduled_time": "2025-12-26 11:33:13.312",
    "end_time": "2025-12-26 11:33:22.455",
    "results": {
      "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxxx"
    }
  },
  "usage": {
    "video_duration": 2.79,
    "video_ratio": "standard"
  }
}

轮询策略

  1. 调用提交视频生成任务接口获取 task_id
  2. 15 秒轮询一次,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,从 output.results.video_url 获取视频。

注意事项

  • URL 有效期:视频 URL 在 24 小时后过期,请及时下载保存。
  • 状态流转PENDINGRUNNINGSUCCEEDEDFAILEDUNKNOWN 表示任务不存在或已过期。
任务状态说明
task_status说明
PENDING任务排队中
RUNNING任务处理中
SUCCEEDED任务成功完成
FAILED任务失败
UNKNOWN任务状态未知

鉴权

string
header
必填

千问云 API Key。详见获取 API Key

路径参数

string
必填

提交任务时返回的 task_id

响应

200-application/json
string

本次请求的唯一 ID。

object
object

任务成功时返回的用量信息。