BeatAPIKling 2 6 Motion ControlVideo API

Kling 2.6 Motion Control

Transfer motion from one uploaded MP4/MOV video to one uploaded character image at 720p or 1080p; image orientation supports up to 10 seconds and video orientation up to 30 seconds. ### Supported modes | Mode | Required input | Rules | | --- | --- | --- | | Motion transfer | `model`, `images`, `reference_videos` | Upload both assets through `/v1/files`; image orientation supports up to 10 seconds, video orientation up to 30 seconds, and BeatAPI bills the detected duration. | **Async flow:** Create the task, save `data.id`, then [poll the Task](/quick-guide#get-task-status) with `GET /v1/tasks/{task_id}`. On `succeeded`, read `data.output.media`. On `failed`, read `data.error_code` and `data.error_message`, then follow the [error and retry policy](/quick-guide#errors-and-retry-policy). **Using a local file?** [upload a local input](/quick-guide#upload-an-input-file) first and pass the returned `data.url`.

身份验证

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

请求头

Idempotency-Keystring可选<=255 characters

请求

This endpoint expects an object.
model"kling-2.6-motion-control"必需

Must be kling-2.6-motion-control.

imageslist of strings必需

Exactly one character-image URL returned by the current account’s /v1/files upload.

reference_videoslist of strings必需

Exactly one 3–30 second MP4/MOV URL returned by the current account’s /v1/files upload. Its detected duration determines billing.

promptstring可选<=2500 characters
Optional motion or scene guidance.
resolutionenum可选默认为 720p

Output resolution and per-second price tier.

character_orientationenum可选默认为 image

Image orientation supports motion videos up to 10 seconds; video orientation supports up to 30 seconds.

响应

Video generation task accepted

错误

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
409
Conflict Error
429
Too Many Requests Error