查询视频生成任务

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

任务状态说明

PENDING: 任务排队中，等待处理

RUNNING: 正在生成视频

SUCCEEDED: 生成成功，可获取视频结果

FAILED: 生成失败，查看失败原因

轮询建议

建议每30秒查询一次任务状态，直到任务完成或失败。
通常5秒视频需要2-5分钟，10秒视频需要5-10分钟。

返回响应

🟢200成功

application/json

查询成功

Body

string <uuid>

任务唯一标识符

可选

示例值:

13db8785-77bc-4273-883b-e462f3e7ff52

status

enum<string>

任务当前状态

可选

枚举值:

PENDINGRUNNINGSUCCEEDEDFAILED

示例值:

RUNNING

createdAt

string <date-time>

可选

任务创建时间 (ISO 8601格式)

示例值:

2024-11-15T03:34:51.751Z

progress

number

可选

任务进度，范围 0.0 - 1.0

0.0: 刚开始

0.5: 进行中

1.0: 已完成

>= 0<= 1

示例值:

0.275

output

array[string <uri>]

可选

生成成功时的视频下载链接列表(仅当status为SUCCEEDED时存在)

示例值:

["https://storage.runwayml.com/generated_video_123456.mp4"]

failure

object (TaskFailure)

可选

任务失败时的错误信息(仅当status为FAILED时存在)

code

string

错误代码

可选

示例值:

INVALID_INPUT

message

string

错误描述

可选

示例值:

输入图片格式不支持

示例

生成中生成成功

{
    "id": "13db8785-77bc-4273-883b-e462f3e7ff52",
    "status": "RUNNING",
    "createdAt": "2024-11-15T03:34:51.751Z",
    "progress": 0.275
}

🟠401没有权限

🟠404记录不存在

🔴500服务器错误

查询视频生成任务

任务状态说明

轮询建议

请求参数

示例代码

返回响应

查询视频生成任务

任务状态说明#

轮询建议#

请求参数

示例代码

返回响应

任务状态说明

轮询建议