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
string
required
API key authentication, format:
Bearer YOUR_API_KEYPath Parameters
string
required
Task ID returned from the create video interface
Response
string
Request status:
success or errorobject
Response data object
Show Success Response
Show Success Response
Show Error Response
Show Error Response
string
Error message description
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
⌘I