Skip to main content
POST

Authentication

Authorization
string
required
All requests require Bearer Token authenticationGet your API Key:Visit the API Key Management page to obtain your API KeyAdd the following header to each request:

Request Parameters

model
string
required
Model name: kling-v3-motion-control or kling-v2-6-motion-control
prompt
string
Text prompt describing the desired motion, camera movement, and styleOptional but recommended — more specific descriptions produce more stable resultsExample: "The character dances following the reference video, smooth motion, realistic style"
image_url
string
required
Reference image URLMust be a publicly accessible link
video_url
string
required
Reference video URLMust be a publicly accessible direct link; mp4/mov recommended, under 100MB
The server probes the actual duration of video_url. Minimum is 3 seconds; maximum is determined by character_orientation.
keep_original_sound
string
default:"yes"
Whether to retain the original audio track from the reference videoOptions:
  • yes: Keep original audio (default)
  • no: Do not keep original audio
character_orientation
string
required
Character orientation controlOptions:
  • image: Use the character orientation from the reference image (reference video duration: 3~10s)
  • video: Use the character orientation from the reference video (reference video duration: 3~30s)
mode
string
required
Generation modeOptions:
  • std: Standard mode (balanced speed and quality)
  • pro: High-quality mode (higher latency)
watermark_info
object
Watermark control object (optional)

Duration Rules

Billing duration is determined by the actual duration probed from video_url by the server, not a client-side estimate.

Response

code
integer
Response status code, 200 on success
data
array
Response data array

Examples

Example 1: image orientation (within 10s)

Example 2: video orientation (within 30s)