GlobalAiOpcGlobalAiOpc
wechatwechat
GlobalAiOpc

Grok - Query Task

Query the status and result of Grok video generation tasks

GET/kyyReactApiServer/v1/result/{id}

Grok Query Video Task

Use the task ID to query the status and result of a Grok video generation task.

Authentication

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 of the video generation task, returned by the create task API.
The create API returns the field id directly. Use that value as the id here.

Response Parameters

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

Status Flow

queued

The task has been created and added to the queue.

processing

The Grok model is actively generating the video.

completed

The task has completed successfully and the result is available through video_url.

Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 30-60 seconds
  • Completion time depends on the model, duration, and reference image count
  • grok_video3_max can take longer in long-duration or reference-heavy cases
  • Stop polling when the status becomes completed or failed

Result Notes

Important:
  • Generated result URLs are usually temporary, so save them promptly
  • Longer durations and more reference images usually mean longer processing time
  • Invalid prompts or unsupported reference images may cause task failure