轮询视频生成状态
/v1/videos/{video_id}轮询由 POST /v1/videos 创建的视频生成任务。使用提交响应中的任务 id 查询生成是否仍在排队、生成中、已完成或已失败。
认证
Authorization Bearer
在 Authorization 请求头中使用 API Key 作为 Bearer Token。
路径参数
video_idstringrequired视频任务 ID。
Response
idstring视频任务 ID。
objectstring对象类型，固定为 video。
statusstring视频任务的当前状态。
modelstring使用的模型。
promptstring输入提示词。
created_atintegerUnix 创建时间戳。
updated_atintegerUnix 最后更新时间戳。
parametersobject生成参数回显，例如 resolution、duration、aspect_ratio、seed、audio、watermark。
responseobject可用时返回的原始响应详情。
urlstring预签名视频 URL；当 status 为 completed 时返回。
video_urlstring视频 URL（如可用）。
durationinteger视频最终时长（秒）；完成时返回。
contentobject返回时包含的额外生成资产。
content.last_frame_urlstring当 return_last_frame=true 且返回最后一帧时的图片 URL。
errorobject | null错误详情；当 status 为 failed 时返回。
error.codestring错误代码。
error.messagestring错误信息。
usageobject可用时返回的用量和计费详情。
usage.prompt_tokensintegerInput token count when returned.
usage.completion_tokensintegerOutput token count when returned.
usage.total_tokensintegerTotal token count when returned.
usage.input_tokensintegerInput token count for providers that use input/output names.
usage.output_tokensintegerOutput token count for providers that use input/output names.
usage.generated_imagesintegerGenerated image count when returned.
usage.audio_duration_secondsnumberAudio duration used for billing when returned.
usage.video_duration_secondsnumberVideo duration used for billing when returned.
usage.provider_request_idstringProvider request ID used for upstream correlation.
根据模型供应商的不同，可能包含供应商特定的额外字段（例如 resolution、fileformat、frames、generate_audio、response.*）。
Polling Behavior
queued：任务已接收，等待开始。in_progress：正在生成，继续轮询。completed：结果已准备好，通过url或video_url获取生成视频。failed：生成失败，查看error.code和error.message。