GET /v1/videos/

Method: GETEndpoint: /v1/videos/{task_id}

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

status ： queued、in_progress、completed、failed

Request Parameters

Path Parameters

task_id
string
Required

Header Parameters

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

Example Request

Shell

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

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "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
}