Kling V2.1 Pro

curl --request POST \
  --url https://whollyapi.com/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image_url": "<string>",
    "tail_image_url": "<string>",
    "duration": "<string>",
    "negative_prompt": "<string>",
    "cfg_scale": "<string>"
  }
}
'

import requests

url = "https://whollyapi.com/api/v1/jobs/createTask"

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "tail_image_url": "<string>",
        "duration": "<string>",
        "negative_prompt": "<string>",
        "cfg_scale": "<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>',
    input: {
      prompt: '<string>',
      image_url: '<string>',
      tail_image_url: '<string>',
      duration: '<string>',
      negative_prompt: '<string>',
      cfg_scale: '<string>'
    }
  })
};

fetch('https://whollyapi.com/api/v1/jobs/createTask', 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://whollyapi.com/api/v1/jobs/createTask",
  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>',
    'input' => [
        'prompt' => '<string>',
        'image_url' => '<string>',
        'tail_image_url' => '<string>',
        'duration' => '<string>',
        'negative_prompt' => '<string>',
        'cfg_scale' => '<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://whollyapi.com/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\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://whollyapi.com/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://whollyapi.com/api/v1/jobs/createTask")

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  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\n}"

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

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "taskId": "<string>"
  }
}

POST

api

jobs

createTask

Kling V2.1 Pro

curl --request POST \
  --url https://whollyapi.com/api/v1/jobs/createTask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "input": {
    "prompt": "<string>",
    "image_url": "<string>",
    "tail_image_url": "<string>",
    "duration": "<string>",
    "negative_prompt": "<string>",
    "cfg_scale": "<string>"
  }
}
'

import requests

url = "https://whollyapi.com/api/v1/jobs/createTask"

payload = {
    "model": "<string>",
    "input": {
        "prompt": "<string>",
        "image_url": "<string>",
        "tail_image_url": "<string>",
        "duration": "<string>",
        "negative_prompt": "<string>",
        "cfg_scale": "<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>',
    input: {
      prompt: '<string>',
      image_url: '<string>',
      tail_image_url: '<string>',
      duration: '<string>',
      negative_prompt: '<string>',
      cfg_scale: '<string>'
    }
  })
};

fetch('https://whollyapi.com/api/v1/jobs/createTask', 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://whollyapi.com/api/v1/jobs/createTask",
  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>',
    'input' => [
        'prompt' => '<string>',
        'image_url' => '<string>',
        'tail_image_url' => '<string>',
        'duration' => '<string>',
        'negative_prompt' => '<string>',
        'cfg_scale' => '<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://whollyapi.com/api/v1/jobs/createTask"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\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://whollyapi.com/api/v1/jobs/createTask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://whollyapi.com/api/v1/jobs/createTask")

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  \"input\": {\n    \"prompt\": \"<string>\",\n    \"image_url\": \"<string>\",\n    \"tail_image_url\": \"<string>\",\n    \"duration\": \"<string>\",\n    \"negative_prompt\": \"<string>\",\n    \"cfg_scale\": \"<string>\"\n  }\n}"

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

{
  "code": 123,
  "msg": "<string>",
  "data": {
    "taskId": "<string>"
  }
}

Generate videos from a source image using the kling/v2-1-pro model.

Authentication

All API requests require a Bearer Token.

Authorization: Bearer YOUR_API_KEY

Create a Video Generation Task

Submit an image-to-video generation task using the endpoint below.

POST /api/v1/jobs/createTask

Request Body

Field	Type	Required	Description
`model`	string	Yes	The model used for video generation.
`input`	object	Yes	Input parameters for the video generation task.

string

required

Must be kling/v2-1-pro.

object

required

Input Parameters

The input object contains the parameters used to generate the video.

string

required

Use prompt to describe the video you want to generate.Maximum length: 5000 characters.

Source Image

string

required

The image_url must contain the URL of an uploaded image.Supported formats:

image/jpeg
image/png

Maximum file size: 10 MB

string

Use tail_image_url to provide an image for the ending frame of the generated video.The image must be an uploaded file URL.Supported formats:

image/jpeg
image/png

Maximum file size: 10 MB

string

Use duration to specify the length of the generated video.Supported values:

"5"
"10"

Default: "5"

string

Use negative_prompt to specify terms or qualities that should be avoided in the generated video.Maximum length: 500 characters.

string

The cfg_scale parameter controls how closely the model follows the prompt.

Setting	Value
Minimum	`0`
Maximum	`1`
Step	`0.1`
Default	`0.5`

Example Request

{
  "model": "kling/v2-1-pro",
  "input": {
    "prompt": "POV shot of a gravity surfer diving between ancient ruins suspended midair, glowing moss lights the path, the board hisses as it carves through thin mist, echoes rise with speed",
    "image_url": "https://demo.com/175489253438680.png",
    "duration": "5",
    "negative_prompt": "blur, distort, and low quality",
    "cfg_scale": 0.5,
    "tail_image_url": ""
  }
}

Response

Successful Response

A successful request returns a task ID.

number

Response status code.

string

Response message. Contains the error description when the request fails.Example: success

object

required

The task data object containing task id.

string

required

The unique identifier for this task.Example: task_123456

Use the returned taskId with the Get Task Details endpoint to check task progress and retrieve the generation results.

Get Task Details

Learn how to query task status and retrieve generation results.

Error Response

{
  "code": 500,
  "msg": "Server Error - An unexpected error occurred while processing the request",
  "data": null
}

API Response Codes

Code	Status	Description
`200`	Success	Request processed successfully.
`401`	Unauthorized	Authentication credentials are missing or invalid.
`402`	Insufficient Credits	The account does not have enough credits to perform the operation.
`404`	Not Found	The requested resource or endpoint does not exist.
`422`	Validation Error	Request parameters failed validation checks.
`429`	Rate Limited	The request limit has been exceeded for this resource.
`433`	Request Limit	Sub-key usage exceeds the allowed limit.
`455`	Service Unavailable	The system is currently undergoing maintenance.
`500`	Server Error	An unexpected error occurred while processing the request.
`501`	Generation Failed	The content generation task failed.
`505`	Feature Disabled	The requested feature is currently disabled.

​Authentication

​Create a Video Generation Task

​Request Body

​Input Parameters

​Source Image

​Example Request

​Response

​Successful Response

Get Task Details

​Error Response

​API Response Codes

Authentication

Create a Video Generation Task

Request Body

Input Parameters

Source Image

Example Request

Response

Successful Response

Error Response

API Response Codes