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())
const taskId = "12345"; // Your task ID
const url = `https://api.scenext.cn/api/get_status/${taskId}`;
const headers = {
"Authorization": "Bearer YOUR_API_KEY"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data));
curl -X GET https://api.scenext.cn/api/get_status/12345 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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"
},
...
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "COMPLETED",
"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"
},
...
],
"consumption":[
{
"type": "score",
"value": 20,
"detail": "Generate video analysis deduction"
}
],
"result": [
{
"type": "video",
"content": "https://oss.scenext.cn/Video/d988d4d9-72f0-4b76-97b0-ca974335dcf4/Manimed6e7bae-cb5d-4e75-a6ae-b4beced80c92.mp4?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749288010&Signature=CZRkEsLpWctM9MS3v7IbpRvMcKI%3D"
}
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "FAILED",
"consumption":[
{
"type": "score",
"value": 0,
"detail": "Generation failed. No points consumed."
}
],
"result": [
{
"type": "text",
"content": "Task execution failed"
}
]
}
}
{
"status": "error",
"data": {
"messages": "Server error: Task not found"
}
}
API Reference
Get Task Status
Query the status and progress of video generation tasks
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())
const taskId = "12345"; // Your task ID
const url = `https://api.scenext.cn/api/get_status/${taskId}`;
const headers = {
"Authorization": "Bearer YOUR_API_KEY"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data));
curl -X GET https://api.scenext.cn/api/get_status/12345 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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"
},
...
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "COMPLETED",
"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"
},
...
],
"consumption":[
{
"type": "score",
"value": 20,
"detail": "Generate video analysis deduction"
}
],
"result": [
{
"type": "video",
"content": "https://oss.scenext.cn/Video/d988d4d9-72f0-4b76-97b0-ca974335dcf4/Manimed6e7bae-cb5d-4e75-a6ae-b4beced80c92.mp4?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749288010&Signature=CZRkEsLpWctM9MS3v7IbpRvMcKI%3D"
}
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "FAILED",
"consumption":[
{
"type": "score",
"value": 0,
"detail": "Generation failed. No points consumed."
}
],
"result": [
{
"type": "text",
"content": "Task execution failed"
}
]
}
}
{
"status": "error",
"data": {
"messages": "Server error: Task not found"
}
}
Get Task Status
This API is used to query the current status, progress, and results of video generation tasks.Request
Request Headers
Path Parameters
Response
Response data object
Show Success Response
Show Success Response
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())
const taskId = "12345"; // Your task ID
const url = `https://api.scenext.cn/api/get_status/${taskId}`;
const headers = {
"Authorization": "Bearer YOUR_API_KEY"
};
fetch(url, {
method: "GET",
headers: headers
})
.then(response => response.json())
.then(data => console.log(data));
curl -X GET https://api.scenext.cn/api/get_status/12345 \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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"
},
...
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "COMPLETED",
"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"
},
...
],
"consumption":[
{
"type": "score",
"value": 20,
"detail": "Generate video analysis deduction"
}
],
"result": [
{
"type": "video",
"content": "https://oss.scenext.cn/Video/d988d4d9-72f0-4b76-97b0-ca974335dcf4/Manimed6e7bae-cb5d-4e75-a6ae-b4beced80c92.mp4?OSSAccessKeyId=LTAI5tDkzckmQzw7eKj4s47h&Expires=1749288010&Signature=CZRkEsLpWctM9MS3v7IbpRvMcKI%3D"
}
]
}
}
{
"status": "success",
"data": {
"task_id": "12345",
"status": "FAILED",
"consumption":[
{
"type": "score",
"value": 0,
"detail": "Generation failed. No points consumed."
}
],
"result": [
{
"type": "text",
"content": "Task execution failed"
}
]
}
}
{
"status": "error",
"data": {
"messages": "Server error: Task not found"
}
}
Polling Recommendations
We recommend polling task status in the following way:- Query immediately after task creation
- Then query every 30 seconds
- Stop polling when status is
COMPLETEDorFAILED
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