Skip to main content
GET
查询视频生成状态

说明

根据任务 ID 查询视频生成任务的当前状态、进度与最终结果。
视频生成为异步任务,建议创建任务后每 5–10 秒轮询一次状态,直到返回 completedfailed

接口概览

请求头

请求参数(Query)

响应结构

状态说明

响应示例

代码示例

注意事项

  • 轮询建议:视频生成需要时间,建议每 5–10 秒查询一次状态
  • 超时处理:如果长时间处于 processing 状态,可能需要重新创建任务
  • 错误处理:当 statusfailed 时,查看 error_message 了解失败原因

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

查询参数

id
string
必填

响应

200 - application/json

成功

id
string

记录 ID

model
string

模型名称

task_id
string

任务 ID

status
enum<string>

任务状态

可用选项:
pending,
processing,
completed,
failed
progress
integer<int64>

进度百分比

video_url
string

视频 URL(completed 后返回)

duration
integer<int64>

实际视频时长(秒)

is_new
boolean

是否为新视频

error_message
string

错误信息(failed 时返回)

created_at
integer<int64>

创建时间戳

completed_at
integer<int64>

完成时间戳

prompt
string

提示词

resolution
string

分辨率,如 720p、1080p

ratio
string

宽高比,如 16:9、9:16、4:3、3:4、1:1

content
object[]

描述视频的文字、图片、音频或视频

provider_specific
object

厂商特定参数