查询任务状态

GET

https://router.shengsuanyun.com/api/v1/tasks/generations/{request_id}

根据请求ID查询视频生成任务的状态和结果。

任务状态说明:

SUBMITTING: 提交中，任务正在提交到系统

PENDING: 待处理，任务已接收但尚未开始处理

SUBMITTED: 已提交，任务已成功提交到处理队列

QUEUED: 排队中，任务在队列中等待资源分配

IN_PROGRESS: 执行中，任务正在处理中

COMPLETED: 已完成，任务成功完成并生成结果

FAILED: 失败，任务处理失败

CANCELLED: 已取消，任务被用户或系统取消

TIMEOUT: 超时，任务处理超时

UNKNOWN: 未知状态，无法确定任务当前状态

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

返回响应

🟢200成功

application/json

查询成功

Body

🟠400请求有误

🟠401未认证

🟠404未找到

🔴500服务器内部错误

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://router.shengsuanyun.com/api/v1/tasks/generations/20250829155118560120000jnBOAS1q' \
--header 'Authorization: Bearer <token>'

响应示例

200 - 任务处理中

{
    "code": "success",
    "message": "",
    "data": {
        "request_id": "20250829155118560120000jnBOAS1q",
        "task_id": "68b15bf74887835d7cf6e20c",
        "action": "VIDEO_GENERATION",
        "status": "IN_PROGRESS",
        "fail_reason": "",
        "submit_time": 1756453878,
        "start_time": 1756453879,
        "finish_time": 0,
        "progress": "45%",
        "data": {}
    }
}

修改于 2025-12-02 05:43:58

异步任务提交

同步图像生成