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}/content 端点允许您获取已完成的 Sora 视频生成任务的实际视频文件内容。此端点提供对生成的视频二进制数据的直接访问。
推荐：使用 meta_data.url当视频状态为 completed 时，获取视频详情 端点的响应中包含 meta_data.url 字段，提供直接下载链接。使用此链接下载视频是推荐的方式，可以避免额外的 API 调用。 使用此端点前，您必须：
- 使用 创建视频 端点生成视频
- 从成功响应中获取
video_id
- 使用 获取视频详情 端点检查视频状态
- 确保状态为
completed 后再尝试下载
重要说明
视频必须已完成只有状态为 completed 的视频才能检索。如果尝试获取仍处于 queued 或 processing 状态的视频内容，您将收到错误响应。请始终先检查视频状态。
资源过期生成的视频有过期时间。请在生成完成后及时下载视频以避免过期。过期后无法检索视频。
Content-Type 处理成功时，此端点返回带有 Content-Type: video/*（通常是 video/mp4）的视频二进制数据。请将响应作为二进制数据处理，而不是 JSON。
自动生成的文档请求参数和响应格式从 OpenAPI 规范自动生成。向下滚动查看交互式 API 参考。
快速开始
基础示例：下载视频
# 首先检查视频状态
curl -X GET "https://api.wisgate.ai/v1/videos/video_68e688d4950481918ec389280c2f78140fcb904657674466" \
-H "Authorization: Bearer $WISDOM_GATE_KEY"
# 状态为 "completed" 后，下载视频
curl -X GET "https://api.wisgate.ai/v1/videos/video_68e688d4950481918ec389280c2f78140fcb904657674466/content" \
-H "Authorization: Bearer $WISDOM_GATE_KEY" \
--output video.mp4
响应处理
成功响应 (200)
视频就绪并成功检索时：
- Content-Type：
video/*（通常是 video/mp4）
- Body：视频文件二进制数据
- 直接将响应保存为视频文件
错误响应
视频未就绪或发生错误时，API 可能返回 JSON 而不是视频数据：
- Content-Type：
application/json
- Body：包含错误信息的 JSON 对象
常见问题
如何判断响应是视频还是 JSON？
检查 Content-Type 头：
- 如果包含
video，响应是视频二进制数据
- 如果是
application/json，将其解析为 JSON 错误信息
返回什么视频格式？
视频以 MP4 格式返回（video/mp4）。
如何处理大视频文件？
对于大视频文件，使用流式下载：
response = requests.get(url, headers=headers, stream=True)
with open('video.mp4', 'wb') as f:
for chunk in response.iter_content(chunk_size=8192):
f.write(chunk)
视频过期后怎么办？
如果视频已过期（超过 expires_at），您将收到 404 或错误响应。视频过期后无法检索。请始终在生成完成后及时下载视频。
