Skip to main content
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "video_url": null,
  "error": null
}

​
Grok Query Video Task

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

​
Authentication

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

​
Path Parameters

​
id
string
required
Unique identifier of the video generation task, returned from the create task endpointExample: video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

​
Response Parameters

​
id
string
Unique identifier of the video generation task
​
object
string
Object type, fixed as video
​
created
integer
Task creation timestamp
​
model
string
Model name used (grok_video3 or grok_video3_pro)
​
status
string
Task status:
  • queued - In queue
  • processing - Processing
  • completed - Completed
  • failed - Failed
​
video_url
string
Generated video URL, returned when status is completed
​
actualDuration
number
Actual output video duration (seconds), returned when status is completed
​
error
string
Error message, returned when status is failed

​
Status Flow

1

queued

Task has been created and added to the queue, waiting to be processed
2

processing

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

completed

Task completed, video generated successfully, results available via video_url

​
Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 30-60 seconds
  • Grok generation speed varies by model and duration:
    • grok_video3 (6-10s): Usually completes in 2-4 minutes
    • grok_video3 (20-30s): Usually completes in 4-8 minutes
    • grok_video3_pro (10s): Usually completes in 3-6 minutes
  • Avoid overly frequent requests to prevent rate limiting
  • Stop polling when status is completed or failed

​
Video URL Notes

Important:
  • Generated video URLs are typically valid for 24 hours
  • Please download and save videos to your storage system promptly
  • Videos will be inaccessible after the URL expires
  • Video files are typically in MP4 format

​
Estimated Generation Time

Grok Video3

Flexible duration (6-30s)Estimated generation time: 2-8 minutes (longer duration = longer generation time)

Grok Video3 Pro

Fixed 10 seconds, high qualityEstimated generation time: 3-6 minutes
Factors Affecting Generation Time:
  • Video duration: Longer duration requires more generation time
  • Resolution selection: 720p takes longer than 480p
  • Number of reference images: Using multiple reference images may increase processing time
  • System load: Peak hours may require longer queue times
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "grok_video3",
  "status": "queued",
  "video_url": null,
  "error": null
}