Skip to main content
GET
/
v1
/
videos
/
{id}
curl --request GET \
  --url https://api.globalaiopc.com/v1/videos/sora_abc123def456 \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "processing",
  "video_url": null,
  "error": null
}

​
Sora Query Video Task

Use the task ID to query the status and results of Sora video generation tasks.

​
Authentication

All requests require a Bearer token in the request header: 
Authorization: Bearer {{key}}

​
Path Parameters

​
id
string
required
Unique identifier for the video generation task, returned from the create task interface

​
Response Parameters

​
id
string
Unique identifier for the video generation task
​
object
string
Object type, always video.generation
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
​
video_url
string
Generated video URL, returned when status is completed
​
error
string
Error message, returned when status is failed

​
Status Flow

1

queued

Task created and added to queue, waiting for processing
2

processing

Task is being processed, Sora model is generating the video
3

completed

Task completed, video generated successfully, result available via video_url

​
Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 30-60 seconds (video generation takes longer)
  • Avoid overly frequent requests to prevent rate limiting
  • Stop polling when status is completed or failed

​
Video URL Information

Important:
  • Generated video URLs typically expire after 24 hours
  • Please download and save videos to your storage system promptly
  • URLs will be inaccessible after expiration
  • Video files are typically in MP4 format

​
Generation Time Estimates

10 Second Video

Estimated generation time: 2-5 minutes

15 Second Video

Estimated generation time: 3-8 minutes

25 Second Video

Estimated generation time: 5-15 minutes (sora-2-pro only)
curl --request GET \
  --url https://api.globalaiopc.com/v1/videos/sora_abc123def456 \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "sora_abc123def456",
  "object": "video.generation",
  "created": 1761635478,
  "model": "sora-2",
  "status": "processing",
  "video_url": null,
  "error": null
}