Skip to main content
POST

Authentication

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

string
required
Model name: kling-v3-motion-control or kling-v2-6-motion-control
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"
string
required
Reference image URLMust be a publicly accessible link
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.
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
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)
string
required
Generation modeOptions:
  • std: Standard mode (balanced speed and quality)
  • pro: High-quality mode (higher latency)
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

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

Examples

Example 1: image orientation (within 10s)

Example 2: video orientation (within 30s)