多元探索 API多元探索 API
OpenAI Format

Grok Task Query

Query Grok video task progress, results, and error information using `GET /v1/videos/{task_id}`.

GEThttps://zx1.deepwl.net/v1/videos/{task_id}
Request
curl https://zx1.deepwl.net/v1/videos/video_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response
{
  "id": "video_abc123",
  "object": "video",
  "model": "grok-video-3",
  "status": "processing",
  "progress": 42,
  "created_at": 1735689600,
  "completed_at": 0,
  "expires_at": 1735776000,
  "seconds": "6",
  "size": "720P",
  "remixed_from_video_id": "",
  "error": {
    "message": "",
    "code": ""
  },
  "video_url": ""
}

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.

Request Headers

Authorizationstring必填

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

Query Parameters

task_idstring必填

Video task ID.

Request Examples

Response Examples

Response Fields

idstring

Task ID.

statusstring

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

progressinteger

Progress percentage.

completed_atinteger

Completion timestamp.

expires_atinteger

Result expiration timestamp.

secondsstring

Output duration.

sizestring

Output resolution tier.

video_urlstring

Video URL. When completed, this field will be read first, or output.url will be read for compatibility.

errorobject

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:

GET /v1/videos/{task_id}/content