# 查询视频进度

**方法**: `GET`
**路径**: `/v1/videos/{task_id}`

<https://platform.openai.com/docs/api-reference/videos/create>

status ：
queued、in\_progress、completed、failed

## 请求参数

### Path 参数

```text
task_id
string
必需
```

### Header 参数

```text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

## 请求示例代码

### Shell

```bash
curl --location --request GET '/v1/videos/' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{
    "id": "video_b9d05dda-0f9d-48c2-944e-7c5b47c6a399",
    "object": "video",
    "model": "sora-2-pro",
    "status": "queued", \\queued、in_progress、completed、failed
    "progress": 0,
    "created_at": 1760679942,
    "seconds": "15",
    "size": "1280x720",
    "error": null,
    "video_url": "" // 成功时，会生成视频链接，也可以通过openai 格式接口获取视频
}
```