ナビゲーションにスキップ
BeatAPIKling 3 Motion ControlVideo API

Kling 3.0 Motion Control

Transfer full-body motion with selectable character orientation and background source at 720p or 1080p; image orientation supports up to 10 seconds and video orientation up to 30 seconds.

Supported modes

ModeRequired inputRules
Motion transfermodel, images, reference_videosUpload both assets through /v1/files; assets must exceed 340 px, use a 2:5–5:2 ratio, and follow the 10s image / 30s video orientation limits.

Async flow: Create the task, save data.id, then poll the Task 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.

Using a local file? upload a local input 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-3-motion-control"必須

Must be kling-3-motion-control.

imageslist of strings必須

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

reference_videoslist of strings必須

Exactly one 3–30 second MP4/MOV URL returned by the current account’s /v1/files upload; maximum 100 MB. 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.

許可された値:
background_sourceenumオプションデフォルト値 input_video
Preserve the background from the motion video or character image.
許可された値:

レスポンス

Video generation task accepted

エラー

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error