Get Video Task Status

Query the local status of an OpenAI/Sora-compatible video task. The task ID comes from the id field returned by Create Video.

Try It

GET/v1/videos/{task_id}https://api-platform.ope.ai

Endpoints

Endpoint	Auth	Purpose
GET /v1/videos/{task_id}	Authorization: Bearer <api-key>	Query your own video task with an API key
GET /api/videos/{task_id}	token: <jwt>	Frontend-token proxy query

Use the token header for a normal frontend JWT. Admin JWTs may use Authorization: Bearer <jwt>.

Authentication

Use Bearer token authentication.

• Header: Authorization: Bearer <api-key>
• Example: Authorization: Bearer sk-xxxxxx

Path Parameters

Parameter	Type	Required	Description
task_id	string	Yes	Video task ID

Request Examples

cURL

curl -X GET "https://api-platform.ope.ai/v1/videos/{task_id}" \
  -H "Authorization: Bearer $OPEAI_API_KEY"

JavaScript

const taskId = "video_690d9b52e2b081908a05ded32cbfc629";
const res = await fetch(`https://api-platform.ope.ai/v1/videos/${taskId}`, {
  headers: {Authorization: `Bearer ${process.env.OPEAI_API_KEY}`},
});

console.log(await res.json());

Python

import os
import requests

resp = requests.get(
    "https://api-platform.ope.ai/v1/videos/video_690d9b52e2b081908a05ded32cbfc629",
    headers={"Authorization": f"Bearer {os.environ['OPEAI_API_KEY']}"},
    timeout=60,
)

print(resp.json())

Response Example

Task statuses come from the platform task table. Common values include NOT_START, SUBMITTED, QUEUED, IN_PROGRESS, SUCCESS, FAILURE, and UNKNOWN. When the status is SUCCESS, you can request the video content.

200

{
  "id": "video_690d9b52e2b081908a05ded32cbfc629",
  "status": "SUCCESS",
  "model": "sora-2",
  "created_at": 1762499410,
  "object": "video",
  "prompt": "Create a short high-definition tech-style video showing AI video generation capabilities.",
  "size": "720x1280"
}

404

{
  "error": {
    "message": "video not found",
    "type": "NotFound",
    "param": "",
    "code": "ResourceNotFound"
  }
}