Get Aliyun Video Task

Query an Aliyun video task. The task ID comes from output.task_id in the Aliyun Video Generation response.

Try It

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

Authentication

Use Bearer token authentication.

• Header: Authorization: Bearer <api-key>
• Example: Authorization: Bearer sk-xxxxxx

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Aliyun video task ID

Request Examples

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());

Response Example

Task statuses use Aliyun format: PENDING, RUNNING, SUCCEEDED, FAILED, CANCELED, and UNKNOWN. When the status is SUCCEEDED, output.video_url contains the generated video URL; you can also call Download Aliyun Video Content to get a binary stream.

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": "A kitten running on grass with a cinematic camera move.",
    "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."
  }
}