获取视频内容

视频任务完成后，可以通过任务结果中的下载地址直接下载，也可以使用 OpenAI 兼容的下载接口获取视频文件。

一、方式一：使用任务结果中的下载地址

获取视频任务进度的响应中，任务完成时会返回 url 字段，直接用该地址下载即可：

curl -o video.mp4 "https://example.com/video.mp4"

视频下载地址通常有时效，建议任务完成后尽快下载。

二、方式二：使用兼容下载接口

（一）接口信息

• 请求方式：GET
• 请求地址：https://www.yunshukjai.com/v1/videos/{video_id}/content
• 鉴权方式：Authorization: Bearer YOUR_API_KEY
• 查询参数：variant（可选），指定返回的资源类型，默认为 MP4
• 前提条件：任务必须处于完成状态（completed / succeeded）

（二）请求示例

curl "https://www.yunshukjai.com/v1/videos/video_123/content" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o video.mp4

接口会直接返回视频文件流（Content-Type: video/mp4），保存为 .mp4 文件即可。

三、注意事项

• 下载前请确认任务状态为完成（completed / succeeded）。
• 如果下载地址过期或返回 404，请重新查询任务状态，获取最新的下载地址。
• 下载完成后建议检查文件大小是否正常，避免拿到不完整的文件。
• 视频资源请及时保存，避免过期后需要重新生成。

相关文档

• 创建视频
• 获取视频任务进度