Creative
Alpha

creative_kling_motion_control

Animate a reference image with motion from a source video when the connected workspace has the Creative flag.

Operation Write.

Parameters

ParameterTypeRequiredDescription
bodyobjectYesVideo settings.
body.image_urlstringYesPublic HTTPS reference image URL.
body.motion_video_urlstringYesPublic HTTPS reference video URL. Up to 100 MB.
body.duration_secondsnumberYesSource duration in seconds. Billing uses the measured duration rounded up.
body.character_orientationstringNoUse video for clips up to 30 seconds, or image for clips up to 10 seconds. Defaults to video.
body.keep_original_soundbooleanNoKeep the source audio. Defaults to true.
body.promptstringNoDescribe the desired action or scene.
body.modestringNoChoose async, sync, subscribe, or webhook.
body.wait_timeout_secondsintegerNoMaximum synchronous wait from 0 to 30 seconds.
body.webhook_urlstringNoPublic HTTPS URL for the terminal job event.
body.project_idstringNoDestination project in the connected workspace.
body.metadataobjectNoCaller data to keep with the job.
idempotency_keystringYesReuse this key to retry the same request.

Pass data.job.id to creative_jobs_wait, then read the saved video with creative_jobs_result.

Sample prompt

Animate my character image using the imported dance clip. Keep the clip’s original audio.