# GET /v1/videos/{task_id}

**Method**: `GET`
**Endpoint**: `/v1/videos/{task_id}`

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

status ：
queued、in\_progress、completed、failed

## Request Parameters

### Path Parameters

```text
task_id
string
Required
```

### Header Parameters

```text
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}
```

## Example Request

### Shell

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

## Response

### 🟢 200 Success

**Content Type**: `application/json`

#### Response Schema

```text
object
```

#### Example

```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": "" // provider-specific note
}
```