Query Task

curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://octopusx.ai/v1/video/query"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://octopusx.ai/v1/video/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://octopusx.ai/v1/video/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://octopusx.ai/v1/video/query"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://octopusx.ai/v1/video/query")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/video/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "",
  "status_update_time": 1759763621142
}

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "completed",
  "video_url": "https://example.com/output.mp4",
  "enhanced_prompt": "make animate",
  "status_update_time": 1759763651908
}

GET

https://octopusx.ai

video

query

Query Task

curl --request GET \
  --url https://octopusx.ai/v1/video/query \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://octopusx.ai/v1/video/query"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://octopusx.ai/v1/video/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://octopusx.ai/v1/video/query",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://octopusx.ai/v1/video/query"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://octopusx.ai/v1/video/query")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/video/query")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "",
  "status_update_time": 1759763621142
}

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "completed",
  "video_url": "https://example.com/output.mp4",
  "enhanced_prompt": "make animate",
  "status_update_time": 1759763651908
}

Query Task

After a Veo unified video task is submitted, use GET /v1/video/query to check its progress and result. The query parameter uses id, whose value is the task ID returned by Create Video.

The route entry is GET /v1/video/query.
The task ID is passed in via the id query parameter.
While processing, statuses such as pending or processing are commonly returned; after completion, video_url will include an accessible address.

Method and Path

GET /v1/video/query?id={task_id}

Request Example

curl "https://octopusx.ai/v1/video/query?id=sora-2:task_01k74ynm13exf9ha36zz7820hv" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

resp = requests.get(
    "https://octopusx.ai/v1/video/query",
    params={"id": "sora-2:task_01k74ynm13exf9ha36zz7820hv"},
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    timeout=30,
)
print(resp.json())

const params = new URLSearchParams({
  id: "sora-2:task_01k74ynm13exf9ha36zz7820hv",
});

const response = await fetch(
  `https://octopusx.ai/v1/video/query?${params.toString()}`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      Accept: "application/json",
    },
  }
);

console.log(await response.json());

Response Example

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "pending",
  "video_url": null,
  "enhanced_prompt": "",
  "status_update_time": 1759763621142
}

{
  "id": "task_01k6x15vhrff09dkkqjrzwhm60",
  "status": "completed",
  "video_url": "https://example.com/output.mp4",
  "enhanced_prompt": "make animate",
  "status_update_time": 1759763651908
}

Some channels also return a more complete detail structure when pending or completed (including upstream task metadata, thumbnails, progress percentage, and more). Please parse compatibly according to the actual response.

Authentication

Authorization: Bearer YOUR_API_KEY

Query Parameters

string

required

Task ID, consistent with the id returned by the create interface.

Response

string

Task ID.

status

string

Task status; common values include pending, processing, completed, and failed.

video_url

string | null

The video result URL. It may be null when the task is not yet complete.

enhanced_prompt

string

The enhanced prompt; may be an empty string if enhancement is not enabled.

status_update_time

integer

The most recent status update time (Unix timestamp, in milliseconds or seconds depending on the upstream source; please refer to the actual response).

Create Video Grok Video Overview

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Query Task

Query Task

Method and Path

Request Example

Response Example

Authentication

Query Parameters

Response

​Query Task

​Method and Path

​Request Example

​Response Example

​Authentication

​Query Parameters

​Response

​Related Interfaces

Query Task

Method and Path

Request Example

Response Example

Authentication

Query Parameters

Response

Related Interfaces