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
}