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用于查询视频生成任务的当前状态、进度和结果。

请求

请求头

Authorization
string
required
API密钥认证,格式:Bearer YOUR_API_KEY

路径参数

task_id
string
required
任务ID,从创建视频接口返回

响应

status
string
请求状态:successerror
data
object
响应数据对象

示例

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"
            },
            ...
        ]
    }
}

轮询建议

建议您按以下方式轮询任务状态:
  1. 任务创建后立即查询一次
  2. 之后每30秒查询一次
  3. 当状态为 COMPLETEDFAILED 时停止轮询

状态说明

  • IN_PROGRESS: 任务正在处理中,可以继续轮询
  • COMPLETED: 任务已成功完成,可以获取结果
  • FAILED: 任务处理失败,请检查错误信息