Kling Task Status Query

curl --request GET \
  --url https://octopusx.ai/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://octopusx.ai/v1/videos/{task_id}"

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/videos/{task_id}', 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/videos/{task_id}",
  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/videos/{task_id}"

	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/videos/{task_id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/videos/{task_id}")

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_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "completed",
  "progress": 100,
  "created_at": 1774494511,
  "completed_at": 1774494622,
  "metadata": {
    "url": "https://example.com/video/aigcVideoGenFile.mp4"
  },
  "video_url": "https://example.com/video/aigcVideoGenFile.mp4"
}

GET

https://octopusx.ai

videos

{task_id}

Kling Task Status Query

curl --request GET \
  --url https://octopusx.ai/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://octopusx.ai/v1/videos/{task_id}"

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/videos/{task_id}', 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/videos/{task_id}",
  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/videos/{task_id}"

	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/videos/{task_id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://octopusx.ai/v1/videos/{task_id}")

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_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "completed",
  "progress": 100,
  "created_at": 1774494511,
  "completed_at": 1774494622,
  "metadata": {
    "url": "https://example.com/video/aigcVideoGenFile.mp4"
  },
  "video_url": "https://example.com/video/aigcVideoGenFile.mp4"
}

Kling Task Status Query

After a Kling series task is submitted, query it via GET /v1/videos/{task_id}.

The query path is GET /v1/videos/{task_id}.
A successful response returns an OpenAI-style video object.
After the task is completed, you can read the result from video_url.

Method and Path

GET /v1/videos/{task_id}

Request Example

curl https://octopusx.ai/v1/videos/video_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

resp = requests.get(
    "https://octopusx.ai/v1/videos/video_123",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(resp.json())

const response = await fetch("https://octopusx.ai/v1/videos/video_123", {
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
  },
});

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

Response Example

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "processing",
  "progress": 50,
  "created_at": 1774494511
}

{
  "id": "task_ZOAIupBoCLMo3dmUGcrKUcUEUnCLctc6",
  "object": "video",
  "model": "kling-3.0-omni-720p-noref-audio",
  "status": "completed",
  "progress": 100,
  "created_at": 1774494511,
  "completed_at": 1774494622,
  "metadata": {
    "url": "https://example.com/video/aigcVideoGenFile.mp4"
  },
  "video_url": "https://example.com/video/aigcVideoGenFile.mp4"
}

Authentication

Authorization: Bearer YOUR_API_KEY

Path Parameters

task_id

string

required

Task ID, which is the same as the id or task_id returned by the generation endpoint.

Response

string

Task ID.

object

string

Always video.

model

string

Model name.

status

string

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

progress

integer

Progress percentage (0-100).

created_at

integer

Creation time (Unix timestamp).

completed_at

integer

Completion time (Unix timestamp), returned only when the task is completed.

metadata

object

Metadata.

metadata.url

string

Video URL (in metadata).

video_url

string

Video URL (same as metadata.url).

Kling Video Generation Veo Video Overview

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Kling Task Status Query

Kling Task Status Query

Method and Path

Request Example

Response Example

Authentication

Path Parameters

Response

​Kling Task Status Query

​Method and Path

​Request Example

​Response Example

​Authentication

​Path Parameters

​Response

​Related APIs

Kling Task Status Query

Method and Path

Request Example

Response Example

Authentication

Path Parameters

Response

Related APIs