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

Kling 3

Generate 3–15 second videos from text or frames, with optional multi-shot and reusable-element controls up to 4K.

Supported modes

ModeRequired inputRules
Text to videomodel, promptOmit images, multi_prompt, and elements.
First framemodel, prompt, imagesProvide one image URL; provide two for first and last frames.
Multi-shotmodel, prompt, multi_shots, multi_promptSet multi_shots=true; shot durations must sum to duration.
Reusable elementmodel, prompt, elementsProvide up to three named image or video reference elements.

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"必須

Must be kling-3.

promptstring必須1-5000 characters
Video generation instructions.
imageslist of stringsオプション

One first-frame image or first- and last-frame images as public HTTPS URLs. Multi-shot mode accepts exactly one.

durationintegerオプション3-15デフォルト値 5
Requested output duration in seconds.
aspect_ratioenumオプション

Defaults to 16:9 for text generation. Omit it with frame images to adapt to the input aspect ratio.

許可された値:
resolutionenumオプションデフォルト値 pro
Output quality tier.
許可された値:
soundbooleanオプション

Generate synchronized sound. Defaults to true in multi-shot mode.

multi_shotsbooleanオプションデフォルト値 false

Enable storyboard-style multi-shot generation.

multi_promptlist of objectsオプション

Shot definitions required when multi_shots=true.

elementslist of objectsオプション
Up to three reusable subject or object references.

レスポンス

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