Kling V3 Motion Control API for Reference-Guided Character Video

Access Kling V3 Motion Control through GoEnhance with model: kling-v3-motion. Supply appearance and motion references, submit one asynchronous request, and track the returned img_uuid by polling or callback.
Get API Key
Cinematic motion-reference production for the Kling V3 Motion Control API

Combine appearance and motion references in one request

Define the character's appearance

Use image_url for a clear upper- or full-body character image, or use at most one Kling element through element_ids. Element input forces character_orientation: video.
Controlled appearance-reference photography for character video generation

Transfer motion from a reference video

Provide a required MP4 or MOV in video_url. The output follows usable continuous motion from that file; this endpoint has no duration parameter.
Single-scene choreography rehearsal used as a motion reference
Validate media before submission; unsupported duration or resolution values should be rejected client-side.

Kling V3 Motion Control API capabilities and validation rules

Endpoint and model

POST to https://api.goenhance.ai/api/v1/videos/generations with model: kling-v3-motion.

Prompt

Send a required prompt of up to 2,500 characters to describe the character, clothing, scene, or relevant generation direction.

Appearance input

An image_url may be JPG, JPEG, or PNG, up to 50 MB, at least 300 px per side, with an aspect ratio from 1:2.5 to 2.5:1.

Motion input

The required video_url must be MP4 or MOV, no larger than 100 MB, with dimensions from 340 to 3,850 px.

Orientation and length

character_orientation: video accepts 3–30 seconds; image accepts 3–10 seconds. The documented default is video.

Resolution and audio

Choose 720p or 1080p; there is no 4K tier. generate_audio keeps the motion video's original sound and defaults to false.
Pricing is per generated second, while GoEnhance measures the input motion-video length as the request's upper-bound charge.

Kling V3 Motion Control API pricing

720p rate

6.3 tokens per generated second, equivalent to $0.126/s at the documented $0.02 per token.

1080p rate

8.4 tokens per generated second, equivalent to $0.168/s at the documented $0.02 per token.

Cost estimate

Estimate the upper-bound request cost as the measured motion-video duration multiplied by the exact rate for the selected resolution.

Measured input billing

GoEnhance transfers and measures video_url before deducting tokens, so changing the remote file after measurement does not change the billed input.

Output may be shorter

Kling extracts usable continuous motion, so difficult or very fast motion can produce an output shorter than the reference video.

No duration parameter

Do not send duration; the endpoint rejects it, and output length follows the usable motion extracted from the reference video.

Integrate Kling V3 Motion Control in six steps

1

1. Create an API key

Create a GoEnhance API key and send it in the Authorization header.
2

2. Validate both references

Check image clarity and dimensions, then verify the motion video's format, size, dimensions, and orientation-dependent length.
3

3. Submit and persist the task

POST the request with model: kling-v3-motion, then save the returned img_uuid before handing work to a background processor.
4

4. Track status

Poll GET /api/v1/jobs/detail or supply a publicly accessible HTTPS custom_callback_url.
5

5. Handle callbacks idempotently

Treat repeated status events safely. A callback that does not return HTTP 200 may be retried up to three times with a three-second timeout per attempt.
6

6. Store the terminal result

Separate processing, success, and failure handling, and save the final video URL only after the task reaches a terminal state.
Get API Key
Use media you are authorized to process and design for asynchronous completion.

Developer use cases for Kling V3 Motion Control

Character performance clips

Apply approved movement references to a consistent character appearance for short narrative or promotional video pipelines.

Dance and choreography previews

Transfer licensed rehearsal motion into character-led previews while preserving consent and source-audio rights.

Game character animation concepts

Generate motion studies from character art and recorded movement before committing to a full animation workflow.

Localized campaign variants

Parameterize prompts and appearance inputs for regional creative variants while reusing one job orchestration layer.

Virtual performer workflows

Build controlled performer pipelines around approved image references, motion assets, and orientation settings.

Previsualization

Test whether a motion reference is suitable for a character before downstream editing, compositing, and review.
Answers to common integration, pricing, validation, and Kuaishou API questions.

Kling V3 Motion Control API FAQ

What is the Kling V3 Motion Control API endpoint?

Submit through GoEnhance at POST https://api.goenhance.ai/api/v1/videos/generations with model: kling-v3-motion. The response returns an img_uuid.

How does Kling V3 Motion Control API pricing work?

720p costs 6.3 tokens/s ($0.126/s), and 1080p costs 8.4 tokens/s ($0.168/s). GoEnhance measures the motion-video duration before deduction as the request's upper-bound charge.

Can I send a duration parameter?

No. This endpoint rejects duration. The reference video must satisfy the orientation-specific limits, and the output follows the usable continuous motion extracted from it.

What does character_orientation change?

video follows the facing direction in the motion video and permits 3–30 seconds. image follows the appearance image and permits 3–10 seconds.

Can the API generate native audio?

No. generate_audio only keeps the motion video's original soundtrack. It defaults to false; use audio only when you have the necessary rights.

Can I use a Kling element instead of an image?

The V3 route accepts at most one value through element_ids (or the single-value alias element_id). Element input forces character_orientation: video.

How do callbacks work?

Supply a public HTTPS custom_callback_url. The callback body matches the job-detail response; non-200 deliveries may be retried up to three times with a three-second timeout.

Is this Kuaishou's official API?

No. Kling is associated with Kuaishou, but this page describes independent access through GoEnhance. GoEnhance is not presented as Kuaishou or Kling's official API, partner, or model developer.

Build with the Kling V3 Motion Control API