The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.
After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.
kling-3.0-motion-control combines one reference image and one reference video to transfer motion to the target character.
Business status code. 200 means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with code: 400 in the body.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"PoYo AI","colors":{"primary":"#4F46E5","light":"#A5B4FC","dark":"#4338CA"},"logo":{"light":"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/light.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=8af87ad322e9698952f9066b10b97f41","dark":"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/dark.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=f3b51af4915305ef51d0bc2b9c809b89"},"favicon":"https://mintcdn.com/goseallc/N1-_FzFDsG6WGTTd/favicon.ico?fit=max\u0026auto=format\u0026n=N1-_FzFDsG6WGTTd\u0026q=85\u0026s=eb4e11a6efd2d4782785543f2e22f387","api":{"openapi":["openapi.json","api-manual/moderation-series/omni-moderation.json","integrations/capability-catalog.json","api-manual/image-series/ideogram-v4-5.json","api-manual/image-series/ideogram-vector-1-0.json","api-manual/music-series/elevenlabs-v4-tts.json","api-manual/music-series/elevenlabs-v4-turbo-tts.json","api-manual/music-series/gemini-3-8-flash-lite-tts.json","api-manual/music-series/gemini-3-8-flash-tts.json","api-manual/3d-series/meshy-7-1-3d.json","api-manual/image-series/gpt-4o-image.json","api-manual/image-series/gpt-image-1.5.json","api-manual/image-series/gpt-image-2.json","api-manual/image-series/gpt-image-2-5-flare.json","api-manual/image-series/gpt-image-2-5-sunburst.json","api-manual/image-series/qwen-image-3.json","api-manual/image-series/qwen-image-2-1.json","api-manual/image-series/nano-banana.json","api-manual/image-series/nano-banana-2.json","api-manual/image-series/nano-banana-2-new.json","api-manual/image-series/nano-banana-2-lite.json","api-manual/image-series/nano-banana-2-1.json","api-manual/image-series/flux-2.json","api-manual/image-series/flux-dev.json","api-manual/image-series/flux-schnell.json","api-manual/image-series/flux-kontext.json","api-manual/image-series/flux-3-klein.json","api-manual/image-series/seedream-4.json","api-manual/image-series/seedream-4-5.json","api-manual/image-series/seedream-5-0-lite.json","api-manual/image-series/seedream-5-0-pro.json","api-manual/image-series/seedream-5-0-flash.json","api-manual/image-series/wan-2-7-image-pro.json","api-manual/image-series/wan-2-7-image.json","api-manual/image-series/z-image.json","api-manual/image-series/grok-imagine-image.json","api-manual/image-series/grok-imagine-image-2-0.json","api-manual/image-series/grok-imagine-image-quality.json","api-manual/image-series/kling-o1.json","api-manual/image-series/kling-o3.json","api-manual/video-series/sora-2.json","api-manual/video-series/sora-2-pro.json","api-manual/video-series/sora-2-official.json","api-manual/video-series/sora-2-pro-official.json","api-manual/video-series/veo-3-1.json","api-manual/video-series/veo-3-1-official.json","api-manual/video-series/flux-3.json","api-manual/video-series/flux-3-max.json","api-manual/video-series/wan-animate.json","api-manual/video-series/wan2.2-text-to-video-fast.json","api-manual/video-series/wan2.2-image-to-video-fast.json","api-manual/video-series/wan2.5-image-to-video.json","api-manual/video-series/wan2.5-text-to-video.json","api-manual/video-series/wan-2-6.json","api-manual/video-series/wan-2-7-video.json","api-manual/video-series/wan-3-0-video.json","api-manual/video-series/wan-3-0-video-prime.json","api-manual/video-series/kling-1-6.json","api-manual/video-series/kling-2-1.json","api-manual/video-series/kling-2-6.json","api-manual/video-series/kling-2.6-motion-control.json","api-manual/video-series/kling-3-0-motion-control.json","api-manual/video-series/kling-2-5-turbo-pro.json","api-manual/video-series/kling-3-0.json","api-manual/video-series/kling-3-0-turbo.json","api-manual/video-series/kling-3-0-4k.json","api-manual/video-series/kling-4-0.json","api-manual/video-series/kling-avatar-2-0.json","api-manual/video-series/kling-o3.json","api-manual/video-series/kling-o3-4k.json","api-manual/video-series/grok-imagine.json","api-manual/video-series/grok-imagine-video-1-5.json","api-manual/video-series/omni-flash.json","api-manual/video-series/gemini-omni-1.1-flash.json","api-manual/video-series/hailuo-02.json","api-manual/video-series/hailuo-2-3.json","api-manual/video-series/hailuo-03.json","api-manual/video-series/h3-max.json","api-manual/video-series/h3-max-turbo.json","api-manual/video-series/seedance-1.0-pro.json","api-manual/video-series/seedance-1-5-pro.json","api-manual/video-series/seedance-2.json","api-manual/video-series/seedance-2.5.json","api-manual/video-series/seedance-2-mini.json","api-manual/video-series/happy-horse.json","api-manual/video-series/happy-horse-1-1.json","api-manual/video-series/runway-gen-4-5.json","api-manual/video-series/vidu-q4.json","api-manual/video-series/omnihuman-2-0.json","api-manual/video-series/pixverse-v6-max.json","api-manual/task-management/3d-status.json","api-manual/task-management/image-status.json","api-manual/task-management/video-status.json","api-manual/3d-series/meshy-6-3d.json","api-manual/3d-series/hunyuan-3d-3-1.json","api-manual/3d-series/tripo-h31-3d.json","api-manual/3d-series/tripo-p1-3d.json","api-manual/music-series/generate-music.json","api-manual/music-series/generate-mashup.json","api-manual/music-series/generate-sounds.json","api-manual/music-series/minimax-music-2.6.json","api-manual/music-series/elevenlabs-music.json","api-manual/music-series/elevenlabs-v3-tts.json","api-manual/music-series/elevenlabs-tts-turbo-2-5.json","api-manual/music-series/gemini-3-1-flash-tts.json","api-manual/music-series/xai-tts-1.json","api-manual/music-series/extend-music.json","api-manual/music-series/upload-and-cover-audio.json","api-manual/music-series/upload-and-extend-audio.json","api-manual/music-series/add-instrumental.json","api-manual/music-series/add-vocals.json","api-manual/music-series/get-timestamped-lyrics.json","api-manual/music-series/boost-music-style.json","api-manual/music-series/generate-music-cover.json","api-manual/music-series/replace-section.json","api-manual/music-series/generate-persona.json","api-manual/music-series/generate-lyrics.json","api-manual/music-series/convert-to-wav.json","api-manual/music-series/vocal-remover/separate-vocals.json","api-manual/music-series/vocal-remover/stem-split.json","api-manual/music-series/vocal-remover/upload-and-separate-vocals.json","api-manual/music-series/voice/validate.json","api-manual/music-series/voice/generate.json","api-manual/music-series/voice/regenerate.json","api-manual/music-series/voice/check.json","api-manual/music-series/create-music-video.json","api-manual/music-series/query-music-detail.json","api-manual/chat-series/chat-completions.json","api-manual/chat-series/responses.json","api-manual/chat-series/claude-messages.json","api-manual/chat-series/gemini-native-format.json","api-manual/chat-series/openai.json","api-manual/chat-series/anthropic.json","api-manual/chat-series/google.json","api-manual/chat-series/deepseek.json","api-manual/chat-series/xai.json","api-manual/chat-series/moonshot.json","api-manual/tools-series/image-translator.json","api-manual/tools-series/video-translator.json","api-manual/tools-series/video-background-removal.json","api-manual/tools-series/video-upscaler.json","api-manual/image-series/gpt-image-2-5-fixed.json","api-manual/image-series/gpt-image-2-6-fixed.json","api-manual/image-series/gpt-image-2-6-flare.json","api-manual/image-series/gpt-image-2-6-sunburst.json","api-manual/music-series/generate-midi.json","api-manual/account-management/user-balance.json","api-manual/file-series/upload-url.json","api-manual/file-series/upload-base64.json","api-manual/file-series/upload-stream.json","zh/openapi.json","zh/api-manual/moderation-series/omni-moderation.json","zh/integrations/capability-catalog.json","zh/api-manual/image-series/ideogram-v4-5.json","zh/api-manual/image-series/ideogram-vector-1-0.json","zh/api-manual/music-series/elevenlabs-v4-tts.json","zh/api-manual/music-series/elevenlabs-v4-turbo-tts.json","zh/api-manual/music-series/gemini-3-8-flash-lite-tts.json","zh/api-manual/music-series/gemini-3-8-flash-tts.json","zh/api-manual/3d-series/meshy-7-1-3d.json","zh/api-manual/image-series/gpt-4o-image.json","zh/api-manual/image-series/gpt-image-1.5.json","zh/api-manual/image-series/gpt-image-2.json","zh/api-manual/image-series/gpt-image-2-5-flare.json","zh/api-manual/image-series/gpt-image-2-5-sunburst.json","zh/api-manual/image-series/qwen-image-3.json","zh/api-manual/image-series/qwen-image-2-1.json","zh/api-manual/image-series/nano-banana.json","zh/api-manual/image-series/nano-banana-2.json","zh/api-manual/image-series/nano-banana-2-new.json","zh/api-manual/image-series/nano-banana-2-lite.json","zh/api-manual/image-series/nano-banana-2-1.json","zh/api-manual/image-series/flux-2.json","zh/api-manual/image-series/flux-dev.json","zh/api-manual/image-series/flux-schnell.json","zh/api-manual/image-series/flux-kontext.json","zh/api-manual/image-series/flux-3-klein.json","zh/api-manual/image-series/seedream-4.json","zh/api-manual/image-series/seedream-4-5.json","zh/api-manual/image-series/seedream-5-0-lite.json","zh/api-manual/image-series/seedream-5-0-pro.json","zh/api-manual/image-series/seedream-5-0-flash.json","zh/api-manual/image-series/wan-2-7-image-pro.json","zh/api-manual/image-series/wan-2-7-image.json","zh/api-manual/image-series/z-image.json","zh/api-manual/image-series/grok-imagine-image.json","zh/api-manual/image-series/grok-imagine-image-2-0.json","zh/api-manual/image-series/grok-imagine-image-quality.json","zh/api-manual/image-series/kling-o1.json","zh/api-manual/image-series/kling-o3.json","zh/api-manual/video-series/sora-2.json","zh/api-manual/video-series/sora-2-pro.json","zh/api-manual/video-series/sora-2-official.json","zh/api-manual/video-series/sora-2-pro-official.json","zh/api-manual/video-series/veo-3-1.json","zh/api-manual/video-series/veo-3-1-official.json","zh/api-manual/video-series/flux-3.json","zh/api-manual/video-series/flux-3-max.json","zh/api-manual/video-series/wan-animate.json","zh/api-manual/video-series/wan2.2-text-to-video-fast.json","zh/api-manual/video-series/wan2.2-image-to-video-fast.json","zh/api-manual/video-series/wan2.5-image-to-video.json","zh/api-manual/video-series/wan2.5-text-to-video.json","zh/api-manual/video-series/wan-2-6.json","zh/api-manual/video-series/wan-2-7-video.json","zh/api-manual/video-series/wan-3-0-video.json","zh/api-manual/video-series/wan-3-0-video-prime.json","zh/api-manual/video-series/kling-1-6.json","zh/api-manual/video-series/kling-2-1.json","zh/api-manual/video-series/kling-2-6.json","zh/api-manual/video-series/kling-2.6-motion-control.json","zh/api-manual/video-series/kling-3-0-motion-control.json","zh/api-manual/video-series/kling-2-5-turbo-pro.json","zh/api-manual/video-series/kling-3-0.json","zh/api-manual/video-series/kling-3-0-turbo.json","zh/api-manual/video-series/kling-3-0-4k.json","zh/api-manual/video-series/kling-4-0.json","zh/api-manual/video-series/kling-avatar-2-0.json","zh/api-manual/video-series/kling-o3.json","zh/api-manual/video-series/kling-o3-4k.json","zh/api-manual/video-series/grok-imagine.json","zh/api-manual/video-series/grok-imagine-video-1-5.json","zh/api-manual/video-series/omni-flash.json","zh/api-manual/video-series/gemini-omni-1.1-flash.json","zh/api-manual/video-series/hailuo-02.json","zh/api-manual/video-series/hailuo-2-3.json","zh/api-manual/video-series/hailuo-03.json","zh/api-manual/video-series/h3-max.json","zh/api-manual/video-series/h3-max-turbo.json","zh/api-manual/video-series/seedance-1.0-pro.json","zh/api-manual/video-series/seedance-1-5-pro.json","zh/api-manual/video-series/seedance-2.json","zh/api-manual/video-series/seedance-2.5.json","zh/api-manual/video-series/seedance-2-mini.json","zh/api-manual/video-series/happy-horse.json","zh/api-manual/video-series/happy-horse-1-1.json","zh/api-manual/video-series/runway-gen-4-5.json","zh/api-manual/video-series/vidu-q4.json","zh/api-manual/video-series/omnihuman-2-0.json","zh/api-manual/video-series/pixverse-v6-max.json","zh/api-manual/task-management/3d-status.json","zh/api-manual/task-management/image-status.json","zh/api-manual/task-management/video-status.json","zh/api-manual/3d-series/meshy-6-3d.json","zh/api-manual/3d-series/hunyuan-3d-3-1.json","zh/api-manual/3d-series/tripo-h31-3d.json","zh/api-manual/3d-series/tripo-p1-3d.json","zh/api-manual/music-series/generate-music.json","zh/api-manual/music-series/generate-mashup.json","zh/api-manual/music-series/generate-sounds.json","zh/api-manual/music-series/minimax-music-2.6.json","zh/api-manual/music-series/elevenlabs-music.json","zh/api-manual/music-series/elevenlabs-v3-tts.json","zh/api-manual/music-series/elevenlabs-tts-turbo-2-5.json","zh/api-manual/music-series/gemini-3-1-flash-tts.json","zh/api-manual/music-series/xai-tts-1.json","zh/api-manual/music-series/extend-music.json","zh/api-manual/music-series/upload-and-cover-audio.json","zh/api-manual/music-series/upload-and-extend-audio.json","zh/api-manual/music-series/add-instrumental.json","zh/api-manual/music-series/add-vocals.json","zh/api-manual/music-series/get-timestamped-lyrics.json","zh/api-manual/music-series/boost-music-style.json","zh/api-manual/music-series/generate-music-cover.json","zh/api-manual/music-series/replace-section.json","zh/api-manual/music-series/generate-persona.json","zh/api-manual/music-series/generate-lyrics.json","zh/api-manual/music-series/convert-to-wav.json","zh/api-manual/music-series/vocal-remover/separate-vocals.json","zh/api-manual/music-series/vocal-remover/stem-split.json","zh/api-manual/music-series/vocal-remover/upload-and-separate-vocals.json","zh/api-manual/music-series/voice/validate.json","zh/api-manual/music-series/voice/generate.json","zh/api-manual/music-series/voice/regenerate.json","zh/api-manual/music-series/voice/check.json","zh/api-manual/music-series/create-music-video.json","zh/api-manual/music-series/query-music-detail.json","zh/api-manual/chat-series/chat-completions.json","zh/api-manual/chat-series/responses.json","zh/api-manual/chat-series/claude-messages.json","zh/api-manual/chat-series/gemini-native-format.json","zh/api-manual/chat-series/openai.json","zh/api-manual/chat-series/anthropic.json","zh/api-manual/chat-series/google.json","zh/api-manual/chat-series/deepseek.json","zh/api-manual/chat-series/xai.json","zh/api-manual/chat-series/moonshot.json","zh/api-manual/tools-series/image-translator.json","zh/api-manual/tools-series/video-translator.json","zh/api-manual/tools-series/video-background-removal.json","zh/api-manual/tools-series/video-upscaler.json","zh/api-manual/image-series/gpt-image-2-5-fixed.json","zh/api-manual/image-series/gpt-image-2-6-fixed.json","zh/api-manual/image-series/gpt-image-2-6-flare.json","zh/api-manual/image-series/gpt-image-2-6-sunburst.json","zh/api-manual/music-series/generate-midi.json","zh/api-manual/account-management/user-balance.json","zh/api-manual/file-series/upload-url.json","zh/api-manual/file-series/upload-base64.json","zh/api-manual/file-series/upload-stream.json"],"playground":{},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.poyo.ai"}},"background":{"color":{"light":"#FFFFFF","dark":"#0B0B0F"}},"navbar":{"links":[{"icon":"discord","href":"https://discord.gg/F8JNuUPB3j","label":"Discord"}],"primary":{"type":"button","label":"Market","href":"https://poyo.ai/models"}},"fonts":{"family":"Geist"},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"goseallc","hasAudioNarration":false,"actualSubdomain":"goseallc","customDomains":["docs.poyo.ai"],"gitSource":{"type":"github","owner":"coolhackboy","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aec58778c2847cc731f0b3e","collectionId":"466d8b0b-04c1-4c69-8704-21171f2d2922","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aec58778c2847cc731f0b3e"},"entitlements":{},"buildId":"6aeda9421c1ad53e50006c75","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"en","tag":"Video Models","count":94},{"language":"zh","tag":"视频模型","count":94},{"language":"en","tag":"Image Models","count":74},{"language":"zh","tag":"图像模型","count":74},{"language":"en","tag":"Music Models","count":72},{"language":"zh","tag":"音乐模型","count":72},{"language":"en","tag":"Suno AI","count":25},{"language":"zh","tag":"Suno AI","count":25},{"language":"en","tag":"LLM Models","count":22},{"language":"zh","tag":"LLM 模型","count":22},{"language":"en","tag":"Platform","count":18},{"language":"zh","tag":"平台","count":18},{"language":"en","tag":"Kling","count":15},{"language":"zh","tag":"Kling","count":15},{"language":"en","tag":"AI Agents","count":13},{"language":"zh","tag":"AI Agent","count":13},{"language":"en","tag":"3D Models","count":12},{"language":"en","tag":"Google","count":12},{"language":"zh","tag":"3D 模型","count":12},{"language":"zh","tag":"Google","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":""}],"page":{"pagePath":"api-manual/video-series/kling-3-0-motion-control","slug":"/api-manual/video-series/kling-3-0-motion-control","pageMetadata":{"title":"Kling 3.0 Motion Control","description":"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.","icon":"video","openapi":"api-manual/video-series/kling-3-0-motion-control.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0-motion-control"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Tip,{children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`After submission, a `,_jsx(_components.code,{children:`task_id`}),` will be returned. If you provided a `,_jsx(_components.code,{children:`callback_url`}),`, when the task status becomes `,_jsx(_components.code,{children:`finished`}),` or `,_jsx(_components.code,{children:`failed`}),`, a POST request will be sent to the `,_jsx(_components.code,{children:`callback_url`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Regardless of whether `,_jsx(_components.code,{children:`callback_url`}),` is provided, you can retrieve the result through the unified `,_jsx(_components.a,{href:`/api-manual/task-management/status`,children:`Query Task Status`}),` endpoint.`]}),`\n`]})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`kling-3.0-motion-control`}),` combines one reference image and one reference video to transfer motion to the target character.`]}),`\n`,_jsx(Heading,{level:`2`,id:`models`,children:`Models`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`kling-3.0-motion-control`}),` - Motion transfer from reference video to reference image`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`required-parameters`,children:`Required parameters`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`image_urls`}),`: Exactly `,_jsx(_components.code,{children:`1`}),` reference image`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`video_urls`}),`: Exactly `,_jsx(_components.code,{children:`1`}),` reference video`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`character_orientation`}),`: `,_jsx(_components.code,{children:`image`}),` or `,_jsx(_components.code,{children:`video`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`optional-parameters`,children:`Optional parameters`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`prompt`}),`: Optional scene prompt`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`resolution`}),`: `,_jsx(_components.code,{children:`720p`}),` or `,_jsx(_components.code,{children:`1080p`}),`. Default is `,_jsx(_components.code,{children:`720p`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`kling_elements`}),`: Optional facial consistency element. Only available when `,_jsx(_components.code,{children:`character_orientation=video`})]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Images support `,_jsx(_components.code,{children:`.jpg`}),`, `,_jsx(_components.code,{children:`.jpeg`}),`, `,_jsx(_components.code,{children:`.png`}),`, up to `,_jsx(_components.code,{children:`10MB`})]}),`\n`,_jsxs(_components.li,{children:[`Videos support `,_jsx(_components.code,{children:`.mp4`}),`, `,_jsx(_components.code,{children:`.mov`}),`, up to `,_jsx(_components.code,{children:`100MB`})]}),`\n`,_jsxs(_components.li,{children:[`Reference video must be at least `,_jsx(_components.code,{children:`3`}),` seconds`]}),`\n`,_jsxs(_components.li,{children:[`When `,_jsx(_components.code,{children:`character_orientation=image`}),`, the reference video must not exceed `,_jsx(_components.code,{children:`10`}),` seconds`]}),`\n`,_jsxs(_components.li,{children:[`When `,_jsx(_components.code,{children:`character_orientation=video`}),`, the reference video must not exceed `,_jsx(_components.code,{children:`30`}),` seconds`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`kling_elements`}),` supports only `,_jsx(_components.code,{children:`1`}),` facial element. Each element requires `,_jsx(_components.code,{children:`frontal_image_url`}),` and `,_jsx(_components.code,{children:`reference_image_urls`}),` with `,_jsx(_components.code,{children:`1`}),` to `,_jsx(_components.code,{children:`3`}),` images`]}),`\n`,_jsxs(_components.li,{children:[`When using `,_jsx(_components.code,{children:`kling_elements`}),`, reference the element in your prompt as `,_jsx(_components.code,{children:`@Element1`})]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Kling 3.0 Motion Control","description":"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.","icon":"video","openapi":"api-manual/video-series/kling-3-0-motion-control.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0-motion-control"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Models","slug":"models","depth":2,"children":[]},{"title":"Required parameters","slug":"required-parameters","depth":2,"children":[]},{"title":"Optional parameters","slug":"optional-parameters","depth":2,"children":[]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Submit Kling 3.0 Motion Control Task","description":"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.","operationId":"submitKling30MotionControlTask","tags":["Kling 3.0 Motion Control"],"requestBody":"cf489068-bd02-49f0-b39b-c443381c3281","responses":{"200":"f0645e0f-3ea5-4d59-ac5c-385b797494ff","400":"98cd6094-6882-4b75-bc03-6da5f3be6f86","401":"d1f97231-af27-4f4c-be5a-13c2987d3eaa"},"method":"post","type":"path","servers":["6f4e943f-4925-4a5c-9b51-958e3f9664ee"],"security":["c435034e-3776-4313-98b8-72eff6deea4c"],"path":"/api/generate/submit","baseUrlOptions":["https://api.poyo.ai"],"title":"Submit Kling 3.0 Motion Control Task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","input"],"properties":{"model":{"type":"string","description":"Kling 3.0 Motion Control model identifier","enum":["kling-3.0-motion-control"],"isRequired":true,"uniqueKey":"model","typeLabel":"enum\u003cstring>"},"input":{"type":"object","required":["image_urls","video_urls","character_orientation"],"properties":{"image_urls":{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"input.image_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"minItems":1,"maxItems":1,"description":"Reference image URL array. Only one image is supported. Supports JPG, JPEG, PNG, max 10MB","example":["https://storage.poyo.ai/kling-3.0-motion-control/reference-image-new.png"],"isRequired":true,"uniqueKey":"input.image_urls","typeLabel":"string\u003curi>[]"},"video_urls":{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"input.video_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"minItems":1,"maxItems":1,"description":"Reference video URL array. Only one video is supported. Supports MP4, MOV, max 100MB","example":["https://storage.poyo.ai/kling-3.0-motion-control/reference-video-new.mp4"],"isRequired":true,"uniqueKey":"input.video_urls","typeLabel":"string\u003curi>[]"},"character_orientation":{"type":"string","description":"Character orientation mode","enum":["image","video"],"example":"image","isRequired":true,"uniqueKey":"input.character_orientation","typeLabel":"enum\u003cstring>"},"prompt":{"type":"string","description":"Optional prompt for scene details. Can be empty or up to 2,500 characters.","maxLength":2500,"example":"Keep the character movement smooth and natural","uniqueKey":"input.prompt","typeLabel":"string"},"resolution":{"type":"string","description":"Output resolution","enum":["720p","1080p"],"default":"720p","example":"720p","uniqueKey":"input.resolution","typeLabel":"enum\u003cstring>"},"kling_elements":{"type":"array","maxItems":1,"items":{"type":"object","required":["frontal_image_url","reference_image_urls"],"properties":{"frontal_image_url":{"type":"string","format":"uri","description":"Required frontal image URL for the facial element main view. Supports JPG, JPEG, PNG, WebP, max 10MB","example":"https://example.com/front-face.png","isRequired":true,"uniqueKey":"input.kling_elements.items.[INDEX].frontal_image_url","typeLabel":"string\u003curi>"},"reference_image_urls":{"type":"array","items":{"type":"string","format":"uri","uniqueKey":"input.kling_elements.items.[INDEX].reference_image_urls.items.[INDEX]","typeLabel":"string\u003curi>"},"minItems":1,"maxItems":3,"description":"Additional facial reference image URLs from different angles. 1-3 images are supported","example":["https://example.com/face-angle-1.png"],"isRequired":true,"uniqueKey":"input.kling_elements.items.[INDEX].reference_image_urls","typeLabel":"string\u003curi>[]"}},"uniqueKey":"input.kling_elements.items.[INDEX]","typeLabel":"object"},"description":"Optional facial consistency element definitions. Only available when `character_orientation` is `video`. Only 1 element is supported and can be referenced in the prompt as `@Element1`. When an element is provided, both `frontal_image_url` and `reference_image_urls` are required","example":[{"frontal_image_url":"https://example.com/front-face.png","reference_image_urls":["https://example.com/face-angle-1.png"]}],"uniqueKey":"input.kling_elements","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"input","typeLabel":"object"},"callback_url":{"type":"string","format":"uri","description":"Webhook callback URL for result notifications","example":"https://your-domain.com/callback","uniqueKey":"callback_url","typeLabel":"string\u003curi>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"kling-3-0-motion-control":{"title":"kling-3-0-motion-control","value":{"model":"kling-3.0-motion-control","callback_url":"https://your-domain.com/callback","input":{"image_urls":["https://storage.poyo.ai/kling-3.0-motion-control/reference-image-new.png"],"video_urls":["https://storage.poyo.ai/kling-3.0-motion-control/reference-video-new.mp4"],"character_orientation":"video","resolution":"720p","prompt":"Keep the identity consistent and reference @Element1 for facial details","kling_elements":[{"frontal_image_url":"https://example.com/front-face.png","reference_image_urls":["https://example.com/face-angle-1.png"]}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"f0645e0f-3ea5-4d59-ac5c-385b797494ff":{"description":"Task submitted successfully","content":{"application/json":{"schema":{"type":"object","required":["code","data"],"properties":{"code":{"type":"integer","example":200,"enum":[200,400,401,402,403,404,408,429,500,502,503],"description":"Business status code. `200` means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with `code: 400` in the body.\n\n- `200`: Success\n- `400`: Invalid request parameters\n- `401`: Missing or invalid API key\n- `402`: Insufficient credits\n- `403`: Permission denied\n- `404`: Resource not found\n- `408`: Request timeout\n- `429`: Rate limit exceeded\n- `500`: Internal server error\n- `502`: Upstream service error\n- `503`: Service unavailable\n\nSee [Error Codes](/api-manual/error-codes) for details.","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"data":{"type":"object","required":["task_id","status","created_time"],"properties":{"task_id":{"type":"string","example":"task-unified-1757165031-uyujaw3d","isRequired":true,"uniqueKey":"data.task_id","typeLabel":"string"},"status":{"type":"string","enum":["not_started","running","finished","failed"],"example":"not_started","description":"Task status. Always `not_started` right after submission. Use [Query Task Status](/api-manual/task-management/status) or `callback_url` to get later states.\n\n- `not_started`: Queued, waiting to be processed\n- `running`: Being generated\n- `finished`: Completed; results are in `files` or `output`\n- `failed`: Failed; details are in `error_message`","isRequired":true,"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"created_time":{"type":"string","format":"date-time","example":"2025-11-12T10:30:00","isRequired":true,"uniqueKey":"data.created_time","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":200,"data":{"task_id":"task-unified-1757165031-uyujaw3d","status":"not_started","created_time":"2025-11-12T10:30:00"}}}},"exampleType":"generated"}},"exampleType":"generated"},"98cd6094-6882-4b75-bc03-6da5f3be6f86":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","required":["code","error"],"properties":{"code":{"type":"integer","example":400,"enum":[200,400,401,402,403,404,408,429,500,502,503],"description":"Business status code. `200` means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with `code: 400` in the body.\n\n- `200`: Success\n- `400`: Invalid request parameters\n- `401`: Missing or invalid API key\n- `402`: Insufficient credits\n- `403`: Permission denied\n- `404`: Resource not found\n- `408`: Request timeout\n- `429`: Rate limit exceeded\n- `500`: Internal server error\n- `502`: Upstream service error\n- `503`: Service unavailable\n\nSee [Error Codes](/api-manual/error-codes) for details.","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"error":{"type":"object","required":["message","type"],"properties":{"message":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":400,"error":{"message":"Invalid request parameters","type":"invalid_request_error"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d1f97231-af27-4f4c-be5a-13c2987d3eaa":{"description":"Unauthorized - Invalid API key","content":{"application/json":{"schema":{"type":"object","required":["code","error"],"properties":{"code":{"type":"integer","example":400,"enum":[200,400,401,402,403,404,408,429,500,502,503],"description":"Business status code. `200` means success; any other value means the request failed. Always check this field: some validation errors return HTTP 200 with `code: 400` in the body.\n\n- `200`: Success\n- `400`: Invalid request parameters\n- `401`: Missing or invalid API key\n- `402`: Insufficient credits\n- `403`: Permission denied\n- `404`: Resource not found\n- `408`: Request timeout\n- `429`: Rate limit exceeded\n- `500`: Internal server error\n- `502`: Upstream service error\n- `503`: Service unavailable\n\nSee [Error Codes](/api-manual/error-codes) for details.","isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cinteger>"},"error":{"type":"object","required":["message","type"],"properties":{"message":{"type":"string","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"type":{"type":"string","example":"invalid_request_error","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":400,"error":{"message":"Invalid request parameters","type":"invalid_request_error"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c435034e-3776-4313-98b8-72eff6deea4c":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"6f4e943f-4925-4a5c-9b51-958e3f9664ee":{"url":"https://api.poyo.ai","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"All API endpoints require Bearer Token authentication.\n\nCreate an API key: sign in to PoYo, open **Dashboard → API Key** at [poyo.ai/dashboard/api-key](https://poyo.ai/dashboard/api-key), and click to create a key.\n\nAdd it to the request header:\n\n```\nAuthorization: Bearer YOUR_API_KEY\n```","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-manual/video-series/kling-3-0-motion-control.json"},"subdomain":"goseallc","siteName":"PoYo AI","title":"Kling 3.0 Motion Control - PoYo AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-manual/video-series/kling-3-0-motion-control","matchLevel":0},"zh":{"href":"/zh/api-manual/video-series/kling-3-0-motion-control","matchLevel":1}}},"lastModified":"2026-10-15T09:59:39.921Z","originalFileLocation":"api-manual/video-series/kling-3-0-motion-control.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\">\u003cmeta data-mint-head name=\"application-name\" content=\"PoYo AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Kling 3.0 Motion Control - PoYo AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"PoYo AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://goseallc.mintlify.site/_mintlify/api/og/v2?division=Kling\u0026amp;title=Kling+3.0+Motion+Control\u0026amp;description=The+Kling+3.0+Motion+Control+API+transfers+motion+from+one+reference+video+onto+one+image+at+720p+or+1080p.+Video+orientation+allows+up+to+30+seconds+and+an+opt\u0026amp;theme=ecc0b2c14fb9965076e6096c\u0026amp;signature=8e740bc6ea4232049a862d6c325584f59f5633459d2446f15517dbd494a8a188\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Kling 3.0 Motion Control - PoYo AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://goseallc.mintlify.site/_mintlify/api/og/v2?division=Kling\u0026amp;title=Kling+3.0+Motion+Control\u0026amp;description=The+Kling+3.0+Motion+Control+API+transfers+motion+from+one+reference+video+onto+one+image+at+720p+or+1080p.+Video+orientation+allows+up+to+30+seconds+and+an+opt\u0026amp;theme=ecc0b2c14fb9965076e6096c\u0026amp;signature=8e740bc6ea4232049a862d6c325584f59f5633459d2446f15517dbd494a8a188\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/goseallc/_txJMi_sP9EUfefV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"PoYo AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-manual/video-series/kling-3-0-motion-control.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.poyo.ai/zh/api-manual/video-series/kling-3-0-motion-control\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.poyo.ai/#organization\",\"name\":\"PoYo AI\",\"url\":\"https://docs.poyo.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/goseallc/29Q_kJZSXJtvfdJH/logo/light.svg?fit=max\u0026auto=format\u0026n=29Q_kJZSXJtvfdJH\u0026q=85\u0026s=8af87ad322e9698952f9066b10b97f41\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.poyo.ai#website\",\"name\":\"PoYo AI\",\"url\":\"https://docs.poyo.ai\",\"publisher\":{\"@id\":\"https://docs.poyo.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control#webpage\",\"url\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\",\"name\":\"Kling 3.0 Motion Control\",\"description\":\"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\",\"dateModified\":\"2026-10-15T09:59:39.921Z\",\"isPartOf\":{\"@id\":\"https://docs.poyo.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Video Models\",\"item\":\"https://docs.poyo.ai/api-manual/video-series/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Kling\",\"item\":\"https://docs.poyo.ai/api-manual/video-series/kling-1-6\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Kling 3.0 Motion Control\",\"item\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control#apireference\",\"headline\":\"Kling 3.0 Motion Control\",\"name\":\"Kling 3.0 Motion Control\",\"description\":\"The Kling 3.0 Motion Control API transfers motion from one reference video onto one image at 720p or 1080p. Video orientation allows up to 30 seconds and an optional facial element; image orientation allows up to 10 seconds.\",\"url\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control\",\"mainEntityOfPage\":{\"@id\":\"https://docs.poyo.ai/api-manual/video-series/kling-3-0-motion-control#webpage\"},\"dateModified\":\"2026-10-15T09:59:39.921Z\",\"publisher\":{\"@id\":\"https://docs.poyo.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.poyo.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"PoYo AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"PoYo AI","nav":{"global":{},"languages":[{"language":"en","tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":""}]},{"tab":"Image Models","pages":[{"title":"Image Models","href":"/api-manual/image-series/overview"}]},{"tab":"Video Models","groups":[{"group":"Video Models","pages":[{"title":"Video Models","icon":"video","href":"/api-manual/video-series/overview"},{"group":"Google","pages":[{"title":"VEO 3.1","icon":"video","openapi":"api-manual/video-series/veo-3-1.json POST /api/generate/submit","href":"/api-manual/video-series/veo-3-1"},{"title":"VEO 3.1 Official","icon":"video","openapi":"api-manual/video-series/veo-3-1-official.json POST /api/generate/submit","href":"/api-manual/video-series/veo-3-1-official"},{"title":"Omni Flash","icon":"video","openapi":"api-manual/video-series/omni-flash.json POST /api/generate/submit","href":"/api-manual/video-series/omni-flash"},{"title":"Gemini Omni 1.1 Flash","icon":"video","openapi":"api-manual/video-series/gemini-omni-1.1-flash.json POST /api/generate/submit","href":"/api-manual/video-series/gemini-omni-1.1-flash"}]},{"group":"Flux","pages":[{"title":"Flux 3","icon":"video","openapi":"api-manual/video-series/flux-3.json POST /api/generate/submit","href":"/api-manual/video-series/flux-3"},{"title":"Flux 3 Max","icon":"video","openapi":"api-manual/video-series/flux-3-max.json POST /api/generate/submit","href":"/api-manual/video-series/flux-3-max"}]},{"group":"Wan","pages":[{"title":"Wan Animate","icon":"video","openapi":"api-manual/video-series/wan-animate.json POST /api/generate/submit","href":"/api-manual/video-series/wan-animate"},{"title":"Wan 2.2 Text-to-Video Fast","icon":"video","openapi":"api-manual/video-series/wan2.2-text-to-video-fast.json POST /api/generate/submit","href":"/api-manual/video-series/wan2.2-text-to-video-fast"},{"title":"Wan 2.2 Image-to-Video Fast","icon":"video","openapi":"api-manual/video-series/wan2.2-image-to-video-fast.json POST /api/generate/submit","href":"/api-manual/video-series/wan2.2-image-to-video-fast"},{"title":"Wan 2.5 Image-to-Video","icon":"video","openapi":"api-manual/video-series/wan2.5-image-to-video.json POST /api/generate/submit","href":"/api-manual/video-series/wan2.5-image-to-video"},{"title":"Wan 2.5 Text-to-Video","icon":"video","openapi":"api-manual/video-series/wan2.5-text-to-video.json POST /api/generate/submit","href":"/api-manual/video-series/wan2.5-text-to-video"},{"title":"Wan 2.6","icon":"video","openapi":"api-manual/video-series/wan-2-6.json POST /api/generate/submit","href":"/api-manual/video-series/wan-2-6"},{"title":"Wan 2.7","icon":"video","openapi":"api-manual/video-series/wan-2-7-video.json POST /api/generate/submit","href":"/api-manual/video-series/wan-2-7-video"},{"title":"Wan 3.0","icon":"video","openapi":"api-manual/video-series/wan-3-0-video.json POST /api/generate/submit","href":"/api-manual/video-series/wan-3-0-video"},{"title":"Wan 3.0 Prime","icon":"video","openapi":"api-manual/video-series/wan-3-0-video-prime.json POST /api/generate/submit","href":"/api-manual/video-series/wan-3-0-video-prime"}]},{"group":"Kling","pages":[{"title":"Kling 1.6","icon":"video","openapi":"api-manual/video-series/kling-1-6.json POST /api/generate/submit","href":"/api-manual/video-series/kling-1-6"},{"title":"Kling 2.1","icon":"video","openapi":"api-manual/video-series/kling-2-1.json POST /api/generate/submit","href":"/api-manual/video-series/kling-2-1"},{"title":"Kling 2.5 Turbo Pro","icon":"video","openapi":"api-manual/video-series/kling-2-5-turbo-pro.json POST /api/generate/submit","href":"/api-manual/video-series/kling-2-5-turbo-pro"},{"title":"Kling 2.6","icon":"video","openapi":"api-manual/video-series/kling-2-6.json POST /api/generate/submit","href":"/api-manual/video-series/kling-2-6"},{"title":"Kling 3.0","icon":"video","openapi":"api-manual/video-series/kling-3-0.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0"},{"title":"Kling 3.0 Turbo","icon":"video","openapi":"api-manual/video-series/kling-3-0-turbo.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0-turbo"},{"title":"Kling 3.0 4K","icon":"video","openapi":"api-manual/video-series/kling-3-0-4k.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0-4k"},{"title":"Kling Avatar 2.0","icon":"video","openapi":"api-manual/video-series/kling-avatar-2-0.json POST /api/generate/submit","href":"/api-manual/video-series/kling-avatar-2-0"},{"title":"Kling O3","icon":"video","openapi":"api-manual/video-series/kling-o3.json POST /api/generate/submit","href":"/api-manual/video-series/kling-o3"},{"title":"Kling O3 4K","icon":"video","openapi":"api-manual/video-series/kling-o3-4k.json POST /api/generate/submit","href":"/api-manual/video-series/kling-o3-4k"},{"title":"Kling 2.6 Motion Control","description":"The Kling 2.6 Motion Control API transfers motion from a 3–30 second reference video onto one character image at 720p or 1080p. Image orientation caps the result at 10 seconds; video orientation allows up to 30 seconds.","icon":"video","openapi":"api-manual/video-series/kling-2.6-motion-control.json POST /api/generate/submit","href":"/api-manual/video-series/kling-2.6-motion-control"},{"title":"Kling 3.0 Motion Control","icon":"video","openapi":"api-manual/video-series/kling-3-0-motion-control.json POST /api/generate/submit","href":"/api-manual/video-series/kling-3-0-motion-control"},{"title":"Kling 4.0","description":"Generate videos from text, first and last frames, or visual references, and edit an existing video at 720p or 1080p.","icon":"video","openapi":"api-manual/video-series/kling-4-0.json POST /api/generate/submit","href":"/api-manual/video-series/kling-4-0"}]},{"group":"Grok (xAI)","pages":[{"title":"Grok Imagine","icon":"video","openapi":"api-manual/video-series/grok-imagine.json POST /api/generate/submit","href":"/api-manual/video-series/grok-imagine"},{"title":"Grok Imagine Video 1.5","icon":"video","openapi":"api-manual/video-series/grok-imagine-video-1-5.json POST /api/generate/submit","href":"/api-manual/video-series/grok-imagine-video-1-5"}]},{"group":"Hailuo","pages":[{"title":"Hailuo 02","icon":"video","openapi":"api-manual/video-series/hailuo-02.json POST /api/generate/submit","href":"/api-manual/video-series/hailuo-02"},{"title":"Hailuo 2.3","icon":"video","openapi":"api-manual/video-series/hailuo-2-3.json POST /api/generate/submit","href":"/api-manual/video-series/hailuo-2-3"},{"title":"Hailuo 03","icon":"video","openapi":"api-manual/video-series/hailuo-03.json POST /api/generate/submit","href":"/api-manual/video-series/hailuo-03"},{"title":"H3 Max","icon":"video","openapi":"api-manual/video-series/h3-max.json POST /api/generate/submit","href":"/api-manual/video-series/h3-max"},{"title":"H3 Max Turbo","icon":"video","openapi":"api-manual/video-series/h3-max-turbo.json POST /api/generate/submit","href":"/api-manual/video-series/h3-max-turbo"}]},{"group":"Vidu","pages":[{"title":"Vidu Q4","icon":"video","openapi":"api-manual/video-series/vidu-q4.json POST /api/generate/submit","href":"/api-manual/video-series/vidu-q4"}]},{"group":"PixVerse","pages":[{"title":"PixVerse V6 Max","icon":"video","openapi":"api-manual/video-series/pixverse-v6-max.json POST /api/generate/submit","href":"/api-manual/video-series/pixverse-v6-max"}]},{"group":"ByteDance","pages":[{"title":"OmniHuman 2.0","icon":"video","openapi":"api-manual/video-series/omnihuman-2-0.json POST /api/generate/submit","href":"/api-manual/video-series/omnihuman-2-0"}]},{"group":"Runway","pages":[{"title":"Runway Gen-4.5","icon":"video","openapi":"api-manual/video-series/runway-gen-4-5.json POST /api/generate/submit","href":"/api-manual/video-series/runway-gen-4-5"}]},{"group":"Seedance","pages":[{"title":"Seedance 1.0 Pro","icon":"video","openapi":"api-manual/video-series/seedance-1.0-pro.json POST /api/generate/submit","href":"/api-manual/video-series/seedance-1.0-pro"},{"title":"Seedance 1.5 Pro","icon":"video","openapi":"api-manual/video-series/seedance-1-5-pro.json POST /api/generate/submit","href":"/api-manual/video-series/seedance-1-5-pro"},{"title":"Seedance 2","icon":"video","openapi":"api-manual/video-series/seedance-2.json POST /api/generate/submit","href":"/api-manual/video-series/seedance-2"},{"title":"Seedance 2 Mini","icon":"video","openapi":"api-manual/video-series/seedance-2-mini.json POST /api/generate/submit","href":"/api-manual/video-series/seedance-2-mini"},{"title":"Seedance 2.5","icon":"video","openapi":"api-manual/video-series/seedance-2.5.json POST /api/generate/submit","href":"/api-manual/video-series/seedance-2.5"}]},{"group":"Alibaba","pages":[{"title":"Happy Horse","icon":"video","openapi":"api-manual/video-series/happy-horse.json POST /api/generate/submit","href":"/api-manual/video-series/happy-horse"},{"title":"Happy Horse 1.1","icon":"video","openapi":"api-manual/video-series/happy-horse-1-1.json POST /api/generate/submit","href":"/api-manual/video-series/happy-horse-1-1"}]}]}]},{"tab":"LLM Models","pages":[{"title":"LLM Models","href":"/api-manual/chat-series/overview"}]},{"tab":"3D Models","pages":[{"title":"3D Models","href":"/api-manual/3d-series/overview"}]},{"tab":"Music Models","pages":[{"title":"Music Models","href":"/api-manual/music-series/overview"}]},{"tab":"AI Tools","pages":[{"title":"AI Tools","href":"/api-manual/tools-series/overview"}]},{"tab":"AI Agents","pages":[{"title":"AI Agents","href":"/integrations/overview"}]}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/api-manual/video-series/kling-3-0-motion-control"}]}]},"basePath":"","title":"Kling 3.0 Motion Control - PoYo AI","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}