查询阿里视频任务

查询阿里视频任务状态。任务 ID 来自 阿里视频生成 响应中的 output.task_id。

Try It

GET/aliyun/v1/tasks/{task_id}https://api-platform.ope.ai

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <api-key>
• 示例：Authorization: Bearer sk-xxxxxx

Path 参数

参数	类型	必填	说明
task_id	string	是	阿里视频任务 ID

请求示例

cURL

curl "https://api-platform.ope.ai/aliyun/v1/tasks/{task_id}" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const taskId = "0385dc79-5ff8-4d82-bcb6-xxxxxx";
const res = await fetch(`https://api-platform.ope.ai/aliyun/v1/tasks/${taskId}`, {
  headers: {Authorization: `Bearer ${process.env.OPEAI_API_KEY}`},
});

console.log(await res.json());

响应示例

任务状态使用阿里格式：PENDING、RUNNING、SUCCEEDED、FAILED、CANCELED、UNKNOWN。当状态为 SUCCEEDED 时，output.video_url 会返回视频地址；也可以调用 下载阿里视频内容 获取二进制流。

SUCCEEDED

{
  "request_id": "2ca1c497-f9e0-449d-9a3f-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-25 11:07:28.590",
    "scheduled_time": "2025-09-25 11:07:35.349",
    "end_time": "2025-09-25 11:17:11.650",
    "orig_prompt": "一只小猫在草地上奔跑，电影感镜头。",
    "video_url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4"
  },
  "usage": {
    "duration": 5,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720
  }
}

FAILED

{
  "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "FAILED",
    "code": "InvalidParameter",
    "message": "The request parameter is invalid."
  }
}