Skip to main content
GET
/
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"
            },
            ...
        ]
    }
}

Documentation Index

Fetch the complete documentation index at: https://docs.scenext.cn/llms.txt

Use this file to discover all available pages before exploring further.

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