Query Video Status

Sora video status query API for checking the current status and result information of a specified video task.

---

Overview

• Method: GET
• Path: /v1/videos/{task_id}
• Content-Type: application/json
• Category: Video Models (Video) / Sora Video

Authentication

• Header: Authorization: Bearer <token>

---

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Video task ID

---

Request Example

curl Example

curl -X GET "https://api.gpt.ge/v1/videos/your_task_id" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YOUR_TOKEN"

JavaScript (fetch) Example

fetch('https://api.gpt.ge/v1/videos/your_task_id', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  }
})
  .then(res => res.json())
  .then(console.log)

Python Example (requests)

import requests

resp = requests.get(
    'https://api.gpt.ge/v1/videos/your_task_id',
    headers={
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
    }
)
print(resp.json())

---

Response Fields

Field	Type	Description
id	string	Video task ID
object	string	Returned object type, usually video
created_at	integer	Creation timestamp
status	string	Task status
completed_at	integer	Completion timestamp
error	null	Error information, null on success
expires_at	integer	Expiration timestamp
model	string	Model used
progress	integer	Task progress
remixed_from_video_id	null	Remix source video ID, currently null if unused
seconds	string	Video duration
size	string	Video size

---

Success Response Example (200)

{
  "id": "video_68f082321ed08193a4eaf01376fa10bc0284bd663de64dc5",
  "object": "video",
  "created_at": 1760592434,
  "status": "completed",
  "completed_at": 1760592506,
  "error": null,
  "expires_at": 1760596106,
  "model": "sora-2",
  "progress": 100,
  "remixed_from_video_id": null,
  "seconds": "4",
  "size": "720x1280"
}