4Z API

motion control

Endpoint: POST https://4zapi.com/kling/v1/videos/motion-control

Parameters

  • Content-Type (header, string): Request body Content-Type, usually application/json
  • Authorization (header, string): Bearer API Key

Request body (application/json)

  • character_orientation (string, required): Character orientation vs image or video enum: image, video image: match image (ref video ≤10s) video: match video (ref video ≤30s)
  • image_url (string, required): Reference image; people/background follow this image. Requirements: realistic or near-realistic cartoon proportions, avoid occlusion; person area >5%; Base64 or reachable URL; .jpg/.jpeg/.png; max 10MB; min side 300px; aspect 1:2.5–2.5:1
  • mode (string, required): Video generation mode enum: std, pro std: standard / cost-effective pro: expert / higher quality
  • video_url (string, required): Video requirements: exactly one realistic full/upper-body person with head, avoid occlusion; clear motion without flips/handstands; single take, person stays in frame. .mp4/.mov; ≤100MB; sides 340–3850px. Min 3s; max 30s if orientation matches video, 10s if matches image. Content validated.
  • callback_url (string): Callback URL invoked on task completion
  • element_list (array<object>): subject reference list
  • external_task_id (string): Custom external task ID for business-side correlation
  • keep_original_sound (string): whether to keep original video audio enum: yes, no yes: keep original audio no: drop original audio
  • model_name (string): default kling-v2-6 kling-v3
  • prompt (string): text prompt, may include positive and negative descriptions use the prompt to add elements / camera moves, etc., see Kling motion-control guide max 2500 characters https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
  • watermark_info (array<object>): whether to also generate a watermarked result

Request example

{
  "character_orientation": "video",
  "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.png",
  "keep_original_sound": "yes",
  "mode": "pro",
  "model_name": "kling-v3",
  "prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
  "video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4"
}