Skip to main content
GET
Grok Task Query

Grok Task Query

OpenAI-format query entry point. If the task was submitted via POST /v1/video/create, please use Query Task. After a Grok series task is submitted, poll the status via GET /v1/videos/{task_id}.
  • The API path is GET /v1/videos/{task_id}.
  • After the task is completed, the result URL can usually be read from video_url or output.url.
  • If directly downloading video_url fails, fall back to GET /v1/videos/{task_id}/content.

Method and Path

Request Example

Response Example

Authentication

Path Parameters

string
required
Video task ID.

Response

string
Task ID.
string
Task status. Common values include processing, failed, and completed.
integer
Progress percentage.
integer
Completion timestamp.
integer
Result expiration timestamp.
string
Output duration.
string
Output resolution tier.
string
Video URL. When completed, this field will be read first, or output.url will be read for compatibility.
object
Failure reason object.

Polling Recommendations

The implementation will obtain the result URL in the following order:
  1. output.url
  2. video_url
  3. url
  4. detail.url
If directly downloading the returned video URL fails, fall back to: