Kling V3 Motion Control

curl --request POST \
  --url https://api.goenhance.ai/api/v1/videos/generations \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v3-motion",
  "prompt": "The girl is wearing a loose gray T-shirt and denim shorts",
  "image_url": "https://example.com/character.png",
  "video_url": "https://example.com/dance.mp4",
  "character_orientation": "video",
  "resolution": "1080p"
}
'

import requests

url = "https://api.goenhance.ai/api/v1/videos/generations"

payload = {
    "model": "kling-v3-motion",
    "prompt": "The girl is wearing a loose gray T-shirt and denim shorts",
    "image_url": "https://example.com/character.png",
    "video_url": "https://example.com/dance.mp4",
    "character_orientation": "video",
    "resolution": "1080p"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'kling-v3-motion',
    prompt: 'The girl is wearing a loose gray T-shirt and denim shorts',
    image_url: 'https://example.com/character.png',
    video_url: 'https://example.com/dance.mp4',
    character_orientation: 'video',
    resolution: '1080p'
  })
};

fetch('https://api.goenhance.ai/api/v1/videos/generations', 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://api.goenhance.ai/api/v1/videos/generations",
  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' => 'kling-v3-motion',
    'prompt' => 'The girl is wearing a loose gray T-shirt and denim shorts',
    'image_url' => 'https://example.com/character.png',
    'video_url' => 'https://example.com/dance.mp4',
    'character_orientation' => 'video',
    'resolution' => '1080p'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.goenhance.ai/api/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}")

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

	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://api.goenhance.ai/api/v1/videos/generations")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.goenhance.ai/api/v1/videos/generations")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}"

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

{
  "code": 0,
  "msg": "Success",
  "data": {
    "img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5"
  }
}

Kling

Kling V3 Motion Control

Kling V3 Motion Control. How it works — one appearance reference (an image, or an element on the 3.0 version) plus one motion reference video: the character from the image performs the motion from the video.

⚠️ There is no duration parameter, and this endpoint rejects one. The output length follows your motion video. Before any tokens are deducted, GoEnhance transfers video_url to its own storage and measures the real duration — that measurement is what you are billed for, and it is also what enforces the length limits below. Because the file is measured and then sent onward from GoEnhance’s storage, swapping the URL afterwards has no effect.

Motion video requirements — .mp4 / .mov, ≤100MB, 340–3850px, and:

character_orientation	motion video length
`video` (default)	3–30s
`image`	3–10s

⚠️ Kling bills on the output length, and the model only extracts usable continuous motion — so a difficult or very fast motion can produce a video shorter than the input. GoEnhance charges the measured input length, which is an upper bound.

⚠️ audio has no native option here: generate_audio keeps the motion video’s original sound. It defaults to off, because that soundtrack is often copyrighted material you did not author.

Pricing — per second of generated video, in tokens (USD at $0.02/token). Same as the official rate:

resolution	tokens/s	USD/s
720p	6.3	$0.126
1080p	8.4	$0.168

For a cheaper option with the same parameters, see kling-v2-6-motion — it costs roughly a third less but has no element support.

Returns an img_uuid; poll GET /api/v1/jobs/detail (or use custom_callback_url) to get the generated video.

POST

api

videos

generations

Kling V3 Motion Control

curl --request POST \
  --url https://api.goenhance.ai/api/v1/videos/generations \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-v3-motion",
  "prompt": "The girl is wearing a loose gray T-shirt and denim shorts",
  "image_url": "https://example.com/character.png",
  "video_url": "https://example.com/dance.mp4",
  "character_orientation": "video",
  "resolution": "1080p"
}
'

import requests

url = "https://api.goenhance.ai/api/v1/videos/generations"

payload = {
    "model": "kling-v3-motion",
    "prompt": "The girl is wearing a loose gray T-shirt and denim shorts",
    "image_url": "https://example.com/character.png",
    "video_url": "https://example.com/dance.mp4",
    "character_orientation": "video",
    "resolution": "1080p"
}
headers = {"Content-Type": "application/json"}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'kling-v3-motion',
    prompt: 'The girl is wearing a loose gray T-shirt and denim shorts',
    image_url: 'https://example.com/character.png',
    video_url: 'https://example.com/dance.mp4',
    character_orientation: 'video',
    resolution: '1080p'
  })
};

fetch('https://api.goenhance.ai/api/v1/videos/generations', 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://api.goenhance.ai/api/v1/videos/generations",
  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' => 'kling-v3-motion',
    'prompt' => 'The girl is wearing a loose gray T-shirt and denim shorts',
    'image_url' => 'https://example.com/character.png',
    'video_url' => 'https://example.com/dance.mp4',
    'character_orientation' => 'video',
    'resolution' => '1080p'
  ]),
  CURLOPT_HTTPHEADER => [
    "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://api.goenhance.ai/api/v1/videos/generations"

	payload := strings.NewReader("{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}")

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

	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://api.goenhance.ai/api/v1/videos/generations")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.goenhance.ai/api/v1/videos/generations")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"model\": \"kling-v3-motion\",\n  \"prompt\": \"The girl is wearing a loose gray T-shirt and denim shorts\",\n  \"image_url\": \"https://example.com/character.png\",\n  \"video_url\": \"https://example.com/dance.mp4\",\n  \"character_orientation\": \"video\",\n  \"resolution\": \"1080p\"\n}"

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

{
  "code": 0,
  "msg": "Success",
  "data": {
    "img_uuid": "c12b656c-747a-44fd-9c80-add79b0c52d5"
  }
}

Headers

Authorization

string

Body

application/json

model

enum<string>

required

Model name. Must be kling-v3-motion.

Available options:

kling-v3-motion

prompt

string

required

Text prompt, e.g. what the character wears. Max 2500 characters.

Maximum string length: 2500

image_url

string<uri>

required

Appearance reference image (.jpg / .jpeg / .png, ≤50MB, ≥300px per side, aspect ratio between 1:2.5 and 2.5:1). The character's upper or full body and head must be clearly visible and unobstructed.

video_url

string<uri>

required

Motion reference video. Required. See the requirements above.

character_orientation

enum<string>

default:video

Whether the generated character faces as in the appearance image or as in the motion video. Also caps how long the motion video may be (30s vs 10s).

Available options:

image,

video

resolution

enum<string>

default:720p

Output resolution. Motion control has no 4K tier. quality is accepted as a compatible alias.

Available options:

720p,

1080p

generate_audio

boolean

default:false

Keep the motion video's original sound. There is no generated-audio option on this endpoint.

element_ids

string[]

Optional. At most one element id from Kling's element library, used as the appearance reference instead of (or alongside) image_url. Forces character_orientation: video. element_id is accepted for a single value.

Maximum array length: 1

custom_callback_url

string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code

integer

required

msg

string

required

data

object

required

Show child attributes

Getting started

API

Kling V3 Motion Control

Headers

Body

Response