import requests
task_id = "12345" # 您的任务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"
},
...
]
}
}
API 接口
查询任务状态
查询视频生成任务的状态和进度
GET
/
api
/
get_status
/
{task_id}
import requests
task_id = "12345" # 您的任务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"
},
...
]
}
}
查询任务状态
此API用于查询视频生成任务的当前状态、进度和结果。请求
请求头
API密钥认证，格式：
Bearer YOUR_API_KEY路径参数
任务ID，从创建视频接口返回
响应
请求状态：
success 或 error响应数据对象
显示 成功响应
显示 成功响应
任务ID
任务状态：
IN_PROGRESS: 进行中COMPLETED: 已完成FAILED: 已失败
任务进度信息列表
积分消耗情况（仅在状态为 COMPLETED 和 FAILED 时存在）
任务结果（仅在状态为 COMPLETED 和 FAILED 时存在）
视频标题（仅在状态为 COMPLETED 时存在）
任务创建时间（仅在状态为 COMPLETED 时存在），类型为 ISO 8601 的扩展格式
任务完成时间（仅在状态为 COMPLETED 时存在），类型为 ISO 8601 的扩展格式
显示 错误响应
显示 错误响应
错误信息描述
示例
import requests
task_id = "12345" # 您的任务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"
},
...
]
}
}
轮询建议
建议您按以下方式轮询任务状态：- 任务创建后立即查询一次
- 之后每30秒查询一次
- 当状态为
COMPLETED或FAILED时停止轮询
状态说明
- IN_PROGRESS: 任务正在处理中，可以继续轮询
- COMPLETED: 任务已成功完成，可以获取结果
- FAILED: 任务处理失败，请检查错误信息
⌘I