Kling Video Generation

curl --request POST \
  --url https://zx1.deepwl.net/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "seconds": "<string>",
  "size": "<string>",
  "image": "<string>",
  "metadata": {},
  "metadata.output_config": {},
  "metadata.scene_type": "<string>",
  "metadata.motion_level": "<string>",
  "metadata.offpeak": true,
  "metadata.last_frame_url": "<string>",
  "metadata.video_url": "<string>",
  "metadata.file_infos": "<string>",
  "metadata.ext_info": "<string>"
}
'

import requests

url = "https://zx1.deepwl.net/v1/videos"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "seconds": "<string>",
    "size": "<string>",
    "image": "<string>",
    "metadata": {},
    "metadata.output_config": {},
    "metadata.scene_type": "<string>",
    "metadata.motion_level": "<string>",
    "metadata.offpeak": True,
    "metadata.last_frame_url": "<string>",
    "metadata.video_url": "<string>",
    "metadata.file_infos": "<string>",
    "metadata.ext_info": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    seconds: '<string>',
    size: '<string>',
    image: '<string>',
    metadata: {},
    'metadata.output_config': {},
    'metadata.scene_type': '<string>',
    'metadata.motion_level': '<string>',
    'metadata.offpeak': true,
    'metadata.last_frame_url': '<string>',
    'metadata.video_url': '<string>',
    'metadata.file_infos': '<string>',
    'metadata.ext_info': '<string>'
  })
};

fetch('https://zx1.deepwl.net/v1/videos', 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://zx1.deepwl.net/v1/videos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'seconds' => '<string>',
    'size' => '<string>',
    'image' => '<string>',
    'metadata' => [
        
    ],
    'metadata.output_config' => [
        
    ],
    'metadata.scene_type' => '<string>',
    'metadata.motion_level' => '<string>',
    'metadata.offpeak' => true,
    'metadata.last_frame_url' => '<string>',
    'metadata.video_url' => '<string>',
    'metadata.file_infos' => '<string>',
    'metadata.ext_info' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://zx1.deepwl.net/v1/videos"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://zx1.deepwl.net/v1/videos")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/videos")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}"

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

{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "kling-3.0-omni-720p-ref-audio",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

POST

https://zx1.deepwl.net

videos

Kling Video Generation

curl --request POST \
  --url https://zx1.deepwl.net/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "seconds": "<string>",
  "size": "<string>",
  "image": "<string>",
  "metadata": {},
  "metadata.output_config": {},
  "metadata.scene_type": "<string>",
  "metadata.motion_level": "<string>",
  "metadata.offpeak": true,
  "metadata.last_frame_url": "<string>",
  "metadata.video_url": "<string>",
  "metadata.file_infos": "<string>",
  "metadata.ext_info": "<string>"
}
'

import requests

url = "https://zx1.deepwl.net/v1/videos"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "seconds": "<string>",
    "size": "<string>",
    "image": "<string>",
    "metadata": {},
    "metadata.output_config": {},
    "metadata.scene_type": "<string>",
    "metadata.motion_level": "<string>",
    "metadata.offpeak": True,
    "metadata.last_frame_url": "<string>",
    "metadata.video_url": "<string>",
    "metadata.file_infos": "<string>",
    "metadata.ext_info": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    seconds: '<string>',
    size: '<string>',
    image: '<string>',
    metadata: {},
    'metadata.output_config': {},
    'metadata.scene_type': '<string>',
    'metadata.motion_level': '<string>',
    'metadata.offpeak': true,
    'metadata.last_frame_url': '<string>',
    'metadata.video_url': '<string>',
    'metadata.file_infos': '<string>',
    'metadata.ext_info': '<string>'
  })
};

fetch('https://zx1.deepwl.net/v1/videos', 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://zx1.deepwl.net/v1/videos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'model' => '<string>',
    'prompt' => '<string>',
    'seconds' => '<string>',
    'size' => '<string>',
    'image' => '<string>',
    'metadata' => [
        
    ],
    'metadata.output_config' => [
        
    ],
    'metadata.scene_type' => '<string>',
    'metadata.motion_level' => '<string>',
    'metadata.offpeak' => true,
    'metadata.last_frame_url' => '<string>',
    'metadata.video_url' => '<string>',
    'metadata.file_infos' => '<string>',
    'metadata.ext_info' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://zx1.deepwl.net/v1/videos"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://zx1.deepwl.net/v1/videos")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://zx1.deepwl.net/v1/videos")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"seconds\": \"<string>\",\n  \"size\": \"<string>\",\n  \"image\": \"<string>\",\n  \"metadata\": {},\n  \"metadata.output_config\": {},\n  \"metadata.scene_type\": \"<string>\",\n  \"metadata.motion_level\": \"<string>\",\n  \"metadata.offpeak\": true,\n  \"metadata.last_frame_url\": \"<string>\",\n  \"metadata.video_url\": \"<string>\",\n  \"metadata.file_infos\": \"<string>\",\n  \"metadata.ext_info\": \"<string>\"\n}"

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

{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "kling-3.0-omni-720p-ref-audio",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

Kling Video Generation

Kling uses POST /v1/videos to submit tasks, with JSON submission as the primary method.

The route entry is POST /v1/videos.
JSON submission is currently used.
Supports multiple scenarios, including text-to-video, image-to-video, and first-and-last-frame video generation.
Extended parameters, including output configuration and scenario type, are passed through the metadata field.
After a successful submission, the task id and status are returned, and the result is later polled via Task Status Query.

Supported Models

Kling-3.0-Omni: Kling 3.0 all-in-one version
Kling-2.6: Kling 2.6 version
Kling-2.5: Kling 2.5 version

Method and Path

POST /v1/videos

Request Example

curl -X POST https://zx1.deepwl.net/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Kling-3.0-Omni",
    "prompt": "Cyberpunk city night scene, the camera slowly pushes in",
    "seconds": "5",
    "metadata": {
      "output_config": {
        "resolution": "720P",
        "aspect_ratio": "16:9"
      }
    }
  }'

import requests

resp = requests.post(
    "https://zx1.deepwl.net/v1/videos",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "model": "Kling-3.0-Omni",
        "prompt": "Cyberpunk city night scene, the camera slowly pushes in",
        "seconds": "5",
        "metadata": {
            "output_config": {
                "resolution": "720P",
                "aspect_ratio": "16:9",
            }
        },
    },
    timeout=60,
)
print(resp.json())

const response = await fetch("https://zx1.deepwl.net/v1/videos", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "Kling-3.0-Omni",
    prompt: "Cyberpunk city night scene, the camera slowly pushes in",
    seconds: "5",
    metadata: {
      output_config: {
        resolution: "720P",
        aspect_ratio: "16:9",
      },
    },
  }),
});

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

Scenario Examples

Text-to-Video

{
  "model": "Kling-3.0-Omni",
  "prompt": "Cyberpunk city night scene, the camera slowly pushes in",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}

Image-to-Video

{
  "model": "Kling-3.0-Omni",
  "prompt": "Make the character walk forward and smile",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "9:16"
    }
  }
}

First-and-Last-Frame Video Generation

{
  "model": "Kling-3.0-Omni",
  "prompt": "In a silent system space, the character is illuminated by a blue panel",
  "seconds": "15",
  "size": "720x1280",
  "metadata": {
    "output_config": {
      "duration": 15,
      "resolution": "720P",
      "aspect_ratio": "9:16",
      "audio_generation": "Enabled"
    },
    "last_frame_url": "https://example.com/last-frame.png"
  }
}

Motion Control

{
  "model": "Kling-3.0-Omni",
  "prompt": "The character waves hello",
  "image": "https://example.com/character.png",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "output_config": {
      "resolution": "1080P",
      "aspect_ratio": "16:9"
    }
  }
}

Response Example

Note: The model field in the response may include a billing-spec suffix (such as 720p-ref-audio), which differs from the model name passed in the request.

{
  "id": "video_123",
  "task_id": "video_123",
  "object": "video",
  "model": "kling-3.0-omni-720p-ref-audio",
  "status": "queued",
  "progress": 0,
  "created_at": 1712697600
}

Authentication

Authorization: Bearer YOUR_API_KEY

Body

string

required

Model name. For example, Kling-3.0-Omni, Kling-2.6, Kling-2.5.

string

required

Prompt. The text description for video generation, supporting both Chinese and English.

string

Video duration. For example, 5, 10, 15.

string

Video size. Fast size input, for example 720x1280.

string

Reference image. Reference image URL.

object

Metadata. A container for extended parameters. It is recommended to place all upstream native parameters in metadata.

object

Output configuration. It is recommended to place all native parameters in output_config.

duration: duration (seconds)
resolution: resolution (720P, 1080P)
aspect_ratio: aspect ratio (16:9, 9:16, 1:1)
audio_generation: audio generation (Enabled, Disabled)

string

Scene type. Examples: motion_control (motion control), avatar_i2v (digital human generation), lip_sync (lip sync), template_effect (template effects).

string

Motion level. Examples: std (standard), pro (professional, used for motion control billing tiers).

boolean

Whether off-peak billing is used. true: generate video off-peak; false: generate video immediately.

string

Last frame in first-and-last-frame generation. Specify the tail-frame image URL when generating a first-and-last-frame video.

string

Reference video URL.

string

File information. Native FileInfos passthrough (advanced usage).

string

Extended information. Native ExtInfo string passthrough (advanced usage).

Response

string

Task ID.

string

Task ID (same as id).

string

Fixed to video.

string

Model name.

string

Task status. Common values include queued, processing, completed, failed, cancelled.

integer

Progress percentage (0-100).

integer

Creation time (Unix timestamp).

Overview

Text Models

Image Models

Video Models

Uploads

Tasks

Account

Kling Video Generation

Kling Video Generation

Supported Models

Method and Path

Request Example

Scenario Examples

Text-to-Video

Image-to-Video

First-and-Last-Frame Video Generation

Motion Control

Response Example

Authentication

Body

Response

​Kling Video Generation

​Supported Models

​Method and Path

​Request Example

​Scenario Examples

​Text-to-Video

​Image-to-Video

​First-and-Last-Frame Video Generation

​Motion Control

​Response Example

​Authentication

​Body

​Response

​Related APIs

Kling Video Generation

Supported Models

Method and Path

Request Example

Scenario Examples

Text-to-Video

Image-to-Video

First-and-Last-Frame Video Generation

Motion Control

Response Example

Authentication

Body

Response

Related APIs