悦动人像 EMO — 查询视频生成结果

查询悦动人像 EMO 视频生成任务状态，获取生成的视频

GET

/tasks/{task_id}

cURL

curl --location 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "8190395f-ca1b-4703-9656-xxxxxx",
  "output": {
    "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-11 14:33:38.716",
    "scheduled_time": "2025-09-11 14:33:53.089",
    "end_time": "2025-09-11 14:35:51.541",
    "results": {
      "video_url": "https://xxx/output.mp4"
    }
  },
  "usage": {
    "video_duration": 13.93,
    "video_ratio": "1:1"
  }
}

查询任务状态并获取生成的视频。

轮询策略

调用提交视频生成任务接口获取 task_id。
每 15 秒轮询一次，直到 task_status 为 SUCCEEDED 或 FAILED。
任务成功后，从 output.results.video_url 获取视频。

注意事项

URL 有效期：视频 URL 在 24 小时后过期，请及时下载保存。
状态流转：PENDING → RUNNING → SUCCEEDED 或 FAILED。UNKNOWN 表示任务不存在或已过期。

鉴权

string

header

必填

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

路径参数

string

必填

提交任务时返回的 task_id。

响应

200-application/json

string

本次请求的唯一 ID。

object

显示子属性

string

异步任务 ID。

enum<string>

任务状态。PENDING：排队等待；RUNNING：处理中；SUCCEEDED：成功；FAILED：失败；UNKNOWN：任务不存在或已过期。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,UNKNOWN

string

任务提交时间。

string

任务开始调度时间。

string

任务结束时间（成功或失败时返回）。

object

任务成功时返回。

显示子属性

string

生成视频的 URL，有效期 24 小时，请及时下载保存。

string

任务失败时的错误码。

string

任务失败时的错误信息。

object

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

显示子属性

number

生成视频的时长，单位为秒。

string

生成视频的宽高比，例如 1:1、3:4。

​轮询策略

​注意事项

鉴权

路径参数

响应

轮询策略

注意事项