Unified Video

Query Task

Use `GET /v1/video/query` to query Grok unified video task status and results.

GEThttps://zx1.deepwl.net/v1/video/query
Request
curl "https://zx1.deepwl.net/v1/video/query?id=grok:48a67431-0708-46d1-9ab9-83cb84700153" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
Response
{
  "id": "grok:05c8e247-7e64-472a-acb1-e7f2de5d0d04",
  "status": "processing",
  "video_url": null,
  "status_update_time": 1762780400,
  "progress": 50
}

After a Grok unified video task is submitted, query its progress and results via GET /v1/video/query. The query parameter uses id, whose value is the task ID returned by Create Video.

  • The task ID is passed via the Query parameter id, and its format is usually grok:....
  • After completion, video_url will include an accessible URL; while processing, it may be null.

Request Headers

Authorizationstring必填

Authentication header. Uses a Bearer token, e.g. Bearer YOUR_API_KEY.

Query Parameters

idstring必填

Task ID, which is the same as the id returned by the creation API.

Request Examples

Response Examples

Some channels may also return extended fields such as asset_id, video_file_id, and trace_id; please refer to the actual response.

Response Fields

idstring

Task ID.

statusstring

Task status. Common values include processing, completed, failed, and unknown.

video_urlstring | null

Video result URL. May be null when the task is not yet complete.

status_update_timeinteger

The most recent status update time (Unix timestamp).

progressinteger

Task progress percentage, included in some responses.

promptstring

Echo of the submitted prompt.

ratiostring

Echo of the video ratio, for example 3:2.

thumbnail_urlstring

Thumbnail URL, may appear after completion.