Skip to main content
GET
https://api.scenext.cn
/
api
/
get_status
/
{task_id}
import requests

task_id = "12345"  # Your task ID
url = f"https://api.scenext.cn/api/get_status/{task_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

{
    "status": "success",
    "data": {
        "task_id": "12345",
        "status": "IN_PROGRESS",
        "progress": [
            {
                "id": "frame1",
                "image": "https://oss.scenext.cn/frame_img/d988d4d9-72f0-4b76-97b0-ca974335dcf4/ed6e7bae-cb5d-4e75-a6ae-b4beced80c92/frame1.png?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749287113&Signature=ZofSGtAyhO3KolVaMC8ICUZJNWE%3D"
            },
            {
                "id": "frame2",
                "image": "https://oss.scenext.cn/frame_img/d988d4d9-72f0-4b76-97b0-ca974335dcf4/ed6e7bae-cb5d-4e75-a6ae-b4beced80c92/frame3.png?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749287134&Signature=5zB4nuv7PQkPDCzbKLMQBlb9f%2Bo%3D"
            },
            ...
        ]
    }
}

​
Get Task Status

This API is used to query the current status, progress, and results of video generation tasks.

​
Request

​
Request Headers

​
Authorization
string
required
API key authentication, format: Bearer YOUR_API_KEY

​
Path Parameters

​
task_id
string
required
Task ID returned from the create video interface

​
Response

​
status
string
Request status: success or error
​
data
object
Response data object

​
Examples

import requests

task_id = "12345"  # Your task ID
url = f"https://api.scenext.cn/api/get_status/{task_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

{
    "status": "success",
    "data": {
        "task_id": "12345",
        "status": "IN_PROGRESS",
        "progress": [
            {
                "id": "frame1",
                "image": "https://oss.scenext.cn/frame_img/d988d4d9-72f0-4b76-97b0-ca974335dcf4/ed6e7bae-cb5d-4e75-a6ae-b4beced80c92/frame1.png?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749287113&Signature=ZofSGtAyhO3KolVaMC8ICUZJNWE%3D"
            },
            {
                "id": "frame2",
                "image": "https://oss.scenext.cn/frame_img/d988d4d9-72f0-4b76-97b0-ca974335dcf4/ed6e7bae-cb5d-4e75-a6ae-b4beced80c92/frame3.png?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749287134&Signature=5zB4nuv7PQkPDCzbKLMQBlb9f%2Bo%3D"
            },
            ...
        ]
    }
}

​
Polling Recommendations

We recommend polling task status in the following way:
  1. Query immediately after task creation
  2. Then query every 30 seconds
  3. Stop polling when status is COMPLETED or FAILED

​
Status Descriptions

  • IN_PROGRESS: Task is being processed, you can continue polling
  • COMPLETED: Task has been successfully completed, you can get the results
  • FAILED: Task processing failed, please check the error message