Kling 3.0 Motion Control — Standard API

← Kling 3.0 Motion Control Endpoint: POST https://api.higgsfield.ai/kling-video/v3/motion-control/std Endpoint ID: kling-video/v3/motion-control/std ▶Open API PlaygroundKling 3.0 Motion Control · Standard↗

Usage notes

Use a motion-reference video from 3 to 30 seconds long. The output duration follows the source video; do not send a separate duration field.
Use a character image up to 10 MB with each dimension between 300 and 65,536 pixels. Images outside the 0.4–2.5 width-to-height range are adjusted before generation.
Videos larger than 100 MB are compressed before generation.
Set character_orientation to image or video. keep_original_sound uses the strings yes and no, with yes as the default.
The example.com media URLs are placeholders. Replace them with public HTTPS URLs to your own media before submitting.

Quick start

Replace the example media URLs with publicly accessible URLs for your own files before submitting.

curl --request POST \
  --url https://api.higgsfield.ai/kling-video/v3/motion-control/std \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: ${IDEMPOTENCY_KEY}" \
  --data '{
  "image_url": "https://example.com/character.jpg",
  "video_url": "https://example.com/motion-reference.mp4"
}'

import higgsfield_client

arguments = (
    {'image_url': 'https://example.com/character.jpg',
     'video_url': 'https://example.com/motion-reference.mp4'}
)
result = higgsfield_client.subscribe(
    "kling-video/v3/motion-control/std",
    arguments=arguments,
)
print(result["video"]["url"])

import { config, higgsfield } from "@higgsfield/client/v2";

config({ credentials: process.env.HF_CREDENTIALS });

const result = await higgsfield.subscribe("kling-video/v3/motion-control/std", {
  input:
    {
      "image_url": "https://example.com/character.jpg",
      "video_url": "https://example.com/motion-reference.mp4"
    },
  withPolling: true,
});

if (result.status === "completed") {
  console.log(result.video?.url);
}

Input schema

string

default:""

Write your prompt here

string

required

Public URL of the input image. Format: uri.

string

required

Public URL of the source video. Format: uri.

string

default:"yes"

Allowed values: "yes", "no".

string

default:"video"

Generate the orientation of the characters in the video, which can be selected to match the image or the video Allowed values: "image", "video".

Complete JSON schema

{
  "type": "object",
  "title": "Kling V3 Motion Control Playground",
  "required": [
    "image_url",
    "video_url"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "default": "",
      "description": "Write your prompt here"
    },
    "image_url": {
      "type": "string",
      "title": "Image URL",
      "format": "uri"
    },
    "video_url": {
      "type": "string",
      "title": "Video URL",
      "format": "uri"
    },
    "keep_original_sound": {
      "enum": [
        "yes",
        "no"
      ],
      "type": "string",
      "title": "Keep original sound",
      "default": "yes"
    },
    "character_orientation": {
      "enum": [
        "image",
        "video"
      ],
      "type": "string",
      "title": "Character orientation",
      "default": "video",
      "description": "Generate the orientation of the characters in the video, which can be selected to match the image or the video"
    }
  }
}

Response

Submission returns a request handle. Poll status_url until status is completed, or use webhooks.

Accepted

{
  "status": "queued",
  "request_id": "REQUEST_ID",
  "status_url": "https://api.higgsfield.ai/requests/REQUEST_ID/status",
  "cancel_url": "https://api.higgsfield.ai/requests/REQUEST_ID/cancel"
}

A completed response includes the following output fields:

{
  "status": "completed",
  "request_id": "REQUEST_ID",
  "video": {
    "url": "https://example.com/output.mp4"
  }
}

See idempotent requests, polling, request errors and authentication for shared request handling.

Get started

Model API reference

Core concepts

SDKs

Organizations

API reference

Resources

Kling 3.0 Motion Control — Standard API

Usage notes

Quick start

Input schema

Response

​Usage notes

​Quick start

​Input schema

​Response

Usage notes

Quick start

Input schema

Response