跳转到主要内容
GET
/
v1
/
video
/
{video_id}
/
content
Get video content
curl --request GET \
  --url https://wisdom-gate.juheapi.com/v1/video/{video_id}/content \
  --header 'Authorization: Bearer <token>'
"<string>"

​
概述

/v1/video/{video_id}/content 端点允许您获取已完成的 Sora 视频生成任务的实际视频文件内容。此端点提供对生成的视频二进制数据的直接访问。
使用此端点前，您必须：
  1. 使用 创建视频 端点生成视频
  2. 从成功响应中获取 video_id
  3. 使用 获取视频详情 端点检查视频状态
  4. 确保状态为 completed 后再尝试下载

​
重要说明

视频必须已完成只有状态为 completed 的视频才能检索。如果尝试获取仍处于 queued 或 processing 状态的视频内容，您将收到错误响应。请始终先检查视频状态。
资源过期生成的视频有过期时间。请在生成完成后及时下载视频以避免过期。过期后无法检索视频。
Content-Type 处理成功时，此端点返回带有 Content-Type: video/*（通常是 video/mp4）的视频二进制数据。请将响应作为二进制数据处理，而不是 JSON。
自动生成的文档请求参数和响应格式从 OpenAPI 规范自动生成。向下滚动查看交互式 API 参考。

​
快速开始

​
基础示例：下载视频

# 首先检查视频状态
curl -X GET "https://wisdom-gate.juheapi.com/v1/video/video_68e688d4950481918ec389280c2f78140fcb904657674466" \
  -H "Authorization: Bearer $WISDOM_GATE_KEY"

# 状态为 "completed" 后，下载视频
curl -X GET "https://wisdom-gate.juheapi.com/v1/video/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 或错误响应。视频过期后无法检索。请始终在生成完成后及时下载视频。

授权

​
Authorization
string
header
必填

Bearer token authentication. Include your API key in the Authorization header as 'Bearer YOUR_API_KEY'

路径参数

​
video_id
string
必填

The identifier of the video to retrieve content for

响应

Video content retrieved successfully. Returns video binary data when successful, or JSON error object if the video is not ready or an error occurred.

Video file binary data (MP4 format)