Kling CLI

A command-line tool for Kling AI Video Generation via AceDataCloud.

Installation

pip install kling-pro-cli

Usage

# Set your API token
export ACEDATACLOUD_API_TOKEN=your_token

# Generate a video from a text prompt
kling generate "A cinematic scene of a sunset over the ocean"

# Generate a video from a reference image
kling image-to-video "Animate this scene" --start-image-url https://example.com/photo.jpg

# Extend an existing video
kling extend --video-id abc123

# Generate a motion video from image + reference video
kling motion --image-url https://example.com/img.jpg --video-url https://example.com/ref.mp4

# Check task status
kling task abc123-def456

# Wait for a task to complete
kling wait abc123 --interval 5

# List available models
kling models

# Show configuration
kling config

Options

• --token / ACEDATACLOUD_API_TOKEN — API token
• --json — Output raw JSON

Models

License

MIT

Native video and commerce

kling turbo --request-file request.json accepts {"prompt":"Waves at sunset","duration":7}. V3 Turbo supports std 720p/pro 1080p and integer durations 3–15 seconds; native audio is included and cannot be disabled.

kling storyboard --request-file request.json supports V3/V3 Omni automatic or custom multishot generation. For custom shots use shot_type="customize", total duration, and multi_prompt with 1–6 consecutive indices and durations summing to the total.

Use apparel, goods-studio, video-commerce and virtual-try-on with --request-file for structured contents/settings. Product studio requires ref_image and goods_title, an aspect ratio and duration 15/30/60. Try-on requires product_image and person_image URLs. Creator video needs one avatar and a speech_script. Commands output JSON and submit asynchronously by default; use existing task/wait commands for final delivery, or set async=false in the request. Billing follows the selected tier and actual output duration or image count.

Owned assets

kling elements --request-file request.json manages owned/verified preset platform IDs with action=list/presets/retrieve/delete. Custom element creation is unavailable. kling voices --request-file request.json also accepts {"action":"create","voice_name":"Narrator","voice_url":"https://example.com/voice.mp3"}; the recording must contain one clear voice for 5–30 seconds, and creation costs 0.07 Credits.

kling asset-video --request-file request.json accepts platform element_list for V3/V3 Omni/O1 or voice_list for V2.6 pro with native audio enabled. Voice prompts cite the selected voices with <<<voice_1>>>/<<<voice_2>>>; specified voices cost 1.68 Credits/second. Server-side ownership checks apply; presets cannot be deleted. Existing task/wait commands retrieve asynchronous results.