跳转到主要内容
万相 2.1

Wan — 查询结果

查询视频编辑任务状态

GET
/tasks/{task_id}
cURL - 查询任务结果
# 将 {task_id} 替换为提交响应中返回的实际任务 ID
curl -X GET 'https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "request_id": "c1209113-8437-424f-a386-xxxxxx",
  "output": {
    "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
    "task_status": "SUCCEEDED",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "video_count": 1,
    "video_duration": 5
  }
}
查询任务状态并获取编辑后的视频。

轮询策略

  1. 调用编辑视频接口获取 task_id
  2. 15 秒轮询一次本接口,直到 task_statusSUCCEEDEDFAILED
  3. 任务成功后,从 video_url 字段下载视频。

注意事项

  • URL 有效期video_url24 小时后过期,请及时下载。
  • 任务状态流转PENDINGRUNNINGSUCCEEDEDFAILEDCANCELLED

鉴权

string
header
必填

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

路径参数

string
必填

视频编辑任务创建接口返回的任务标识符。

响应

200-application/json
string

唯一请求标识符。

object
object

用量统计(仅在任务成功时存在)。