Kling CLI

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

Get your Ace Data Cloud API key

1. Open Ace Data Cloud → Applications. Sign in, or register an account first.
2. Find General application. If it has not been created, choose Initialize General Application. A general key can use the services available to your account; a dedicated application's key is limited to its service. Check the required service/model access and current pricing.
3. Copy the API Key from the application card, or open Keys / Manage Keys → Create to create a separate key for this integration. Give it a recognizable name so you can revoke or rotate it independently.
4. When creating a key, review Expiration Time, Set Usage Limitation, and Allowed APIs. Enable only the restrictions you need, allow the operations you will call, then click Create and copy the token from the key list. Task lookup does not grant permission to submit a generation. Confirm the application's balance can cover your first request; any trial allowance is whatever your account currently displays.
5. Copy only the token value, without quotation marks, spaces, or Bearer . An API Key / API Token field expects this raw value; only a manually configured HTTP Authorization header needs the Bearer prefix. A platform-... account-management token cannot replace a generation API key.

Save the key in the client's credential store or the environment variable shown below. Never put it in a prompt, shared workflow, screenshot, or Git commit. If authentication fails, check the full copied value, application/service access, expiration, usage limit, and balance before creating another key.

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.

Reference inputs

Use element_list and voice_list only with already valid platform references and the supported model combinations in the current backend guide. Standalone asset creation and management are not published.