获取视频任务状态

GET

/v1/videos/{task_id}

OpenAI 兼容的视频任务状态查询接口（Veo 任务用）。

轮询此接口直到 status 变为 completed，建议 10s 间隔。

完成后获取视频的两种路径

响应里直接返回 url / video_url（逆向上游典型响应）
客户端拿到该 mp4 直链即可直接渲染 / 下载，无需再调 /content 接口。优先级 url > video_url，二者内容一致。

响应中无 url 字段
调 GET /v1/videos/{task_id}/content 由网关代理拉取 mp4 流（官方 Gemini 渠道走这条路径）。

请求参数

Path 参数

Header 参数

返回响应

🟢200成功

application/json

成功获取 Veo 视频任务状态

Bodyapplication/json

🟠404记录不存在

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://api.openai-hub.com/v1/videos/task_sgAaePZCzNYA2tngW6wqCiDoaqklroGV' \
--header 'Authorization: Bearer sk-0ABIEXVjh9****Qckjy'

响应示例

200 - 示例 1

{
    "id": "string",
    "task_id": "string",
    "object": "string",
    "model": "string",
    "status": "queued",
    "progress": 0,
    "created_at": 0,
    "completed_at": 0,
    "seconds": "string",
    "size": "string",
    "url": "https://pro.filesystem.site/cdn/20260505/abc.mp4",
    "video_url": "https://pro.filesystem.site/cdn/20260505/abc.mp4",
    "prompt": "string",
    "error": {
        "message": "string",
        "code": "string"
    }
}

创建视频

获取视频内容

获取视频任务状态

完成后获取视频的两种路径#

请求参数

返回响应

完成后获取视频的两种路径