获取视频内容

下载已完成的视频任务内容。任务未完成时接口会返回错误；任务完成后响应体为视频二进制流。

Try It

GET/v1/videos/{task_id}/contenthttps://api-platform.ope.ai

端点

端点	鉴权	用途
GET /v1/videos/{task_id}/content	Authorization: Bearer <api-key>	API Key 下载视频内容
GET /api/videos/{task_id}/content	token: <jwt>	前台令牌代理下载

普通前台 JWT 推荐放在 token 请求头；管理员 JWT 可使用 Authorization: Bearer <jwt>。

认证

使用 Bearer Token 认证。

• Header：Authorization: Bearer <api-key>
• 示例：Authorization: Bearer sk-xxxxxx

Path 参数

参数	类型	必填	说明
task_id	string	是	视频任务 ID

请求示例

cURL

curl -L "https://api-platform.ope.ai/v1/videos/{task_id}/content" \
  -H "Authorization: Bearer $OPEAI_API_KEY" \
  -o output.mp4

JavaScript

const taskId = "video_690d9b52e2b081908a05ded32cbfc629";
const res = await fetch(`https://api-platform.ope.ai/v1/videos/${taskId}/content`, {
  headers: {Authorization: `Bearer ${process.env.OPEAI_API_KEY}`},
});

const blob = await res.blob();
console.log("status:", res.status, "type:", blob.type, "size:", blob.size);

Python

import os
import requests

with requests.get(
    "https://api-platform.ope.ai/v1/videos/video_690d9b52e2b081908a05ded32cbfc629/content",
    headers={"Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}"},
    stream=True,
    timeout=300,
) as r:
    r.raise_for_status()
    with open("output.mp4", "wb") as f:
        for chunk in r.iter_content(chunk_size=1024 * 1024):
            if chunk:
                f.write(chunk)

响应示例

200

Content-Type: video/mp4 或其他视频格式

响应体为二进制视频流，可直接保存为文件。平台会设置缓存头，便于重复读取已完成任务内容。

HTTP/1.1 200 OK
Content-Type: video/mp4
Content-Length: 15728640

[二进制视频数据]

400

{
  "error": {
    "message": "task not ready",
    "type": "invalid_request_error",
    "param": null,
    "code": "task_not_ready"
  }
}

404

{
  "error": {
    "message": "task not found",
    "type": "not_found_error",
    "param": null,
    "code": "task_not_found"
  }
}