Creative
Alphacreative_kling_motion_control
Animate a reference image with motion from a source video when the connected workspace has the Creative flag.
Operation Write.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
body | object | Yes | Video settings. |
body.image_url | string | Yes | Public HTTPS reference image URL. |
body.motion_video_url | string | Yes | Public HTTPS reference video URL. Up to 100 MB. |
body.duration_seconds | number | Yes | Source duration in seconds. Billing uses the measured duration rounded up. |
body.character_orientation | string | No | Use video for clips up to 30 seconds, or image for clips up to 10 seconds. Defaults to video. |
body.keep_original_sound | boolean | No | Keep the source audio. Defaults to true. |
body.prompt | string | No | Describe the desired action or scene. |
body.mode | string | No | Choose async, sync, subscribe, or webhook. |
body.wait_timeout_seconds | integer | No | Maximum synchronous wait from 0 to 30 seconds. |
body.webhook_url | string | No | Public HTTPS URL for the terminal job event. |
body.project_id | string | No | Destination project in the connected workspace. |
body.metadata | object | No | Caller data to keep with the job. |
idempotency_key | string | Yes | Reuse 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.