mingyanmingyan
wechatwechat
mingyan

Sora - Query Task

Query the status and results of Sora video generation tasks

GET/kyyReactApiServer/v1/videos/{id}

Sora Query Video Task

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

Authentication

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

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired
Unique identifier for the video generation task, returned from the create task interface

Response Parameters

idstring
Unique identifier for the video generation task
objectstring
Object type, always video.generation
createdinteger
Task creation timestamp
modelstring
Model name used
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
video_urlstring
Generated video URL, returned when status is completed
actualDurationnumber
Actual video output duration in seconds, returned when status is completed
errorstring
Error message, returned when status is failed

Status Flow

queued

Task created and added to queue, waiting for processing

processing

Task is being processed, Sora model is generating the video

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 expire after 1 day
  • 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)