Documentation Index
Fetch the complete documentation index at: https://wisdom-docs.juheapi.com/llms.txt
Use this file to discover all available pages before exploring further.
概述
/v1/videos/{video_id} 端点允许您获取 Sora 视频生成任务的详细状态和元数据信息。这是跟踪视频生成进度和获取处理完成后视频详情的主要端点。
使用此端点监控视频生成状态、检查进度，并获取视频尺寸、时长、创建时间和过期时间等元数据。
使用此端点前，您必须先使用 创建视频 端点生成视频以获取视频 ID。
重要说明
自动生成的文档请求参数和响应格式从 OpenAPI 规范自动生成。向下滚动查看交互式 API 参考。
快速开始
基础示例：检查视频状态
响应字段
状态值
status 字段表示视频生成的当前状态：
| 状态 | 描述 |
|---|---|
queued | 视频已排队等待处理 |
processing | 视频正在生成中 |
completed | 视频生成已成功完成 |
failed | 视频生成失败（查看 error 字段） |
关键字段
id：视频的唯一标识符status：当前生成状态progress：生成进度百分比（0-100）created_at：请求创建的 Unix 时间戳completed_at：生成完成的 Unix 时间戳error：生成失败时的错误信息model：用于生成的模型meta_data：元数据对象，包含视频下载链接meta_data.url：生成视频的下载 URL（状态为completed时可用）
常见问题
应该多久轮询一次状态？
建议每 10-30 秒轮询一次。更频繁的轮询是不必要的，可能会触发速率限制。状态为 “completed” 后应该做什么？
状态变为completed 后，您可以：
- 从响应中的
meta_data.url获取视频下载链接 - 使用该 URL 下载视频
- 保存视频 ID 和元数据信息
视频可用多长时间？
查看expires_at 字段了解视频过期时间。请在生成完成后及时下载视频。过期后无法检索视频。