Skip to main content
GET
获取视频生成任务状态

任务状态说明

轮询建议

任务通常在 30 秒至数分钟内完成,具体取决于模型和时长。 建议每 5–10 秒轮询一次,并设置合理超时时间(如 10 分钟)。

授权

Authorization
string
header
必填

使用 Bearer Token 认证,格式:Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

路径参数

task_id
string
必填

任务 ID,由创建接口返回。

响应

成功获取任务状态

通用视频生成任务状态响应。

task_id
string

任务 ID。

示例:

"abcd1234efgh"

status
enum<string>

任务状态。

可用选项:
queued,
in_progress,
completed,
failed
示例:

"completed"

url
string

视频文件 URL,任务 completed 时返回。

示例:

"https://example.com/generated-video.mp4"

format
string

视频格式。

示例:

"mp4"

metadata
object

视频生成任务元数据,包含实际生成的视频规格信息。

error
object

视频任务错误信息。