kling-pro-cli 2026.6.30.0__tar.gz

kling_pro_cli-2026.6.30.0/.env.example

@@ -0,0 +1,4 @@
+# Kling CLI Environment
+ACEDATACLOUD_API_TOKEN=your_api_token_here
+# ACEDATACLOUD_API_BASE_URL=https://api.acedata.cloud
+# KLING_REQUEST_TIMEOUT=1800

kling_pro_cli-2026.6.30.0/.gitignore

@@ -0,0 +1,32 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Environment variables
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# mypy
+.mypy_cache/

kling_pro_cli-2026.6.30.0/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.1.0] - 2025-05-04
+
+### Added
+- Initial release of Kling CLI
+- `kling generate` — Generate video from a text prompt (text2video)
+- `kling image-to-video` — Generate video from reference image(s)
+- `kling extend` — Extend an existing video
+- `kling motion` — Generate motion video from image + reference video
+- `kling task` — Query a single task status
+- `kling tasks` — Query multiple tasks at once
+- `kling wait` — Poll until a task completes
+- `kling models` — List available Kling models
+- `kling config` — Show current configuration
+- `--json` flag on all commands for machine-readable output

kling_pro_cli-2026.6.30.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AceDataCloud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kling_pro_cli-2026.6.30.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.1
+Name: kling-pro-cli
+Version: 2026.6.30.0
+Summary: CLI tool for Kling AI Video Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/KlingCli
+Project-URL: Repository, https://github.com/AceDataCloud/KlingCli
+Project-URL: Issues, https://github.com/AceDataCloud/KlingCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/KlingCli/blob/main/CHANGELOG.md
+Author-email: AceDataCloud <support@acedata.cloud>
+Maintainer-email: AceDataCloud <support@acedata.cloud>
+License: MIT
+License-File: LICENSE
+Keywords: acedata,ai,cli,command-line,generation,kling,video
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: kling-cli[dev,release,test]; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pre-commit>=3.7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: release
+Requires-Dist: build>=1.2.0; extra == 'release'
+Requires-Dist: twine>=6.1.0; extra == 'release'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Kling CLI
+
+A command-line tool for Kling AI Video Generation via [AceDataCloud](https://platform.acedata.cloud).
+
+## Installation
+
+```bash
+pip install kling-pro-cli
+```
+
+## Usage
+
+```bash
+# 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
+
+| Model | Notes |
+|-------|-------|
+| kling-v1 | Default model |
+| kling-v1-6 | Version 1.6 |
+| kling-v2-5-turbo | Version 2.5 Turbo |
+| kling-v2-6 | Version 2.6 |
+| kling-v3 | Version 3 (supports 4K mode) |
+| kling-v3-omni | Version 3 Omni (supports 4K mode) |
+| kling-video-o1 | Video O1 |
+| kling-v2-master | Version 2 Master |
+| kling-v2-1-master | Version 2.1 Master |
+
+## License
+
+MIT

kling_pro_cli-2026.6.30.0/README.md

@@ -0,0 +1,63 @@
+# Kling CLI
+
+A command-line tool for Kling AI Video Generation via [AceDataCloud](https://platform.acedata.cloud).
+
+## Installation
+
+```bash
+pip install kling-pro-cli
+```
+
+## Usage
+
+```bash
+# 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
+
+| Model | Notes |
+|-------|-------|
+| kling-v1 | Default model |
+| kling-v1-6 | Version 1.6 |
+| kling-v2-5-turbo | Version 2.5 Turbo |
+| kling-v2-6 | Version 2.6 |
+| kling-v3 | Version 3 (supports 4K mode) |
+| kling-v3-omni | Version 3 Omni (supports 4K mode) |
+| kling-video-o1 | Video O1 |
+| kling-v2-master | Version 2 Master |
+| kling-v2-1-master | Version 2.1 Master |
+
+## License
+
+MIT

kling_pro_cli-2026.6.30.0/kling_cli/__init__.py

@@ -0,0 +1 @@
+"""Kling CLI - AI Kling Video Generation via AceDataCloud API."""

kling_pro_cli-2026.6.30.0/kling_cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as python -m kling_cli."""
+
+from kling_cli.main import cli
+
+cli()

kling_pro_cli-2026.6.30.0/kling_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Kling CLI commands package."""

kling_pro_cli-2026.6.30.0/kling_cli/commands/info.py

@@ -0,0 +1,53 @@
+"""Info and utility commands."""
+
+import click
+
+from kling_cli.core.config import settings
+from kling_cli.core.output import ASPECT_RATIOS, console, print_models
+
+
+@click.command()
+def models() -> None:
+    """List available Kling models."""
+    print_models()
+
+
+@click.command("aspect-ratios")
+def aspect_ratios() -> None:
+    """List available aspect ratios."""
+    from rich.table import Table
+
+    table = Table(title="Available Aspect Ratios")
+    table.add_column("Ratio", style="bold cyan")
+    table.add_column("Orientation")
+
+    for ratio in ASPECT_RATIOS:
+        w, h = ratio.split(":")
+        if int(w) > int(h):
+            orientation = "Landscape"
+        elif int(w) < int(h):
+            orientation = "Portrait"
+        else:
+            orientation = "Square"
+        table.add_row(ratio, orientation)
+
+    console.print(table)
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="Kling CLI Configuration")
+    table.add_column("Setting", style="bold cyan")
+    table.add_column("Value")
+
+    table.add_row("API Base URL", settings.api_base_url)
+    table.add_row(
+        "API Token",
+        f"{settings.api_token[:8]}..." if settings.api_token else "[red]Not set[/red]",
+    )
+    table.add_row("Request Timeout", f"{settings.request_timeout}s")
+
+    console.print(table)

kling_pro_cli-2026.6.30.0/kling_cli/commands/lipsync.py

@@ -0,0 +1,176 @@
+"""Lip-sync and talking-photo generation commands."""
+
+import click
+
+from kling_cli.core.client import get_client
+from kling_cli.core.exceptions import KlingError
+from kling_cli.core.output import print_error, print_json, print_video_result
+
+TALKING_PHOTO_MODELS = [
+    "kling-v1",
+    "kling-v1-6",
+    "kling-v2-master",
+    "kling-v2-1-master",
+    "kling-v2-5-turbo",
+    "kling-v2-6",
+]
+
+
+def _validate_duration(
+    _ctx: click.Context, _param: click.Parameter, value: int | None
+) -> int | None:
+    """Validate talking-photo duration."""
+    if value is None or value in {5, 10}:
+        return value
+    raise click.BadParameter("Must be 5 or 10.")
+
+
+@click.command("lip-sync")
+@click.option("--video-id", default=None, help="Kling source video ID.")
+@click.option("--video-url", default=None, help="Kling source video URL.")
+@click.option(
+    "--mode",
+    required=True,
+    type=click.Choice(["audio2video", "text2video"]),
+    help="Lip-sync mode.",
+)
+@click.option("--audio-url", default=None, help="Audio URL for audio2video mode.")
+@click.option(
+    "--audio-type",
+    type=click.Choice(["url", "file"]),
+    default=None,
+    help="Audio source type.",
+)
+@click.option("--audio-file", default=None, help="Path or content string for audio2video mode.")
+@click.option("--text", default=None, help="Text for text2video mode.")
+@click.option("--voice-id", default=None, help="Voice ID for text2video mode.")
+@click.option(
+    "--voice-language",
+    type=click.Choice(["zh", "en"]),
+    default=None,
+    help="Voice language for text2video mode.",
+)
+@click.option(
+    "--voice-speed",
+    default=None,
+    type=float,
+    help="Voice speed multiplier for text2video mode (1.0 = normal).",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option(
+    "--async",
+    "async_mode",
+    is_flag=True,
+    default=False,
+    help="Submit asynchronously; returns a task_id to poll instead of waiting.",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def lip_sync(
+    ctx: click.Context,
+    video_id: str | None,
+    video_url: str | None,
+    mode: str,
+    audio_url: str | None,
+    audio_type: str | None,
+    audio_file: str | None,
+    text: str | None,
+    voice_id: str | None,
+    voice_language: str | None,
+    voice_speed: float | None,
+    callback_url: str | None,
+    async_mode: bool,
+    output_json: bool,
+) -> None:
+    """Generate a lip-sync video."""
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.lip_sync(
+            video_id=video_id,
+            video_url=video_url,
+            mode=mode,
+            audio_url=audio_url,
+            audio_type=audio_type,
+            audio_file=audio_file,
+            text=text,
+            voice_id=voice_id,
+            voice_language=voice_language,
+            voice_speed=voice_speed,
+            callback_url=callback_url,
+            **({"async": True} if async_mode else {}),
+        )
+        if output_json:
+            print_json(result)
+        else:
+            print_video_result(result)
+    except KlingError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("talking-photo")
+@click.option("--image-url", required=True, help="Source image URL.")
+@click.option("--audio-url", required=True, help="Source audio URL.")
+@click.option("--prompt", default=None, help="Prompt for talking photo generation.")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(TALKING_PHOTO_MODELS),
+    default=None,
+    help="Model to use for generation.",
+)
+@click.option(
+    "--duration",
+    type=int,
+    callback=_validate_duration,
+    default=None,
+    help="Video duration in seconds.",
+)
+@click.option(
+    "--mode",
+    type=click.Choice(["std", "pro"]),
+    default=None,
+    help="Generation mode: std or pro.",
+)
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option(
+    "--async",
+    "async_mode",
+    is_flag=True,
+    default=False,
+    help="Submit asynchronously; returns a task_id to poll instead of waiting.",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def talking_photo(
+    ctx: click.Context,
+    image_url: str,
+    audio_url: str,
+    prompt: str | None,
+    model: str | None,
+    duration: int | None,
+    mode: str | None,
+    callback_url: str | None,
+    async_mode: bool,
+    output_json: bool,
+) -> None:
+    """Generate a talking-photo video."""
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.talking_photo(
+            image_url=image_url,
+            audio_url=audio_url,
+            prompt=prompt,
+            model=model,
+            duration=duration,
+            mode=mode,
+            callback_url=callback_url,
+            **({"async": True} if async_mode else {}),
+        )
+        if output_json:
+            print_json(result)
+        else:
+            print_video_result(result)
+    except KlingError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

kling_pro_cli-2026.6.30.0/kling_cli/commands/motion.py

@@ -0,0 +1,103 @@
+"""Motion generation command."""
+
+import click
+
+from kling_cli.core.client import get_client
+from kling_cli.core.exceptions import KlingError
+from kling_cli.core.output import (
+    DEFAULT_MODE,
+    KLING_MODES,
+    print_error,
+    print_json,
+    print_video_result,
+)
+
+
+@click.command()
+@click.option(
+    "--image-url",
+    required=True,
+    help="Reference image URL. Characters, backgrounds and elements in the generated video "
+    "are based on this image.",
+)
+@click.option(
+    "--video-url",
+    required=True,
+    help="Reference video URL. Character movements in the generated video are consistent "
+    "with those in this reference video.",
+)
+@click.option(
+    "--character-orientation",
+    default=None,
+    type=click.Choice(["image", "video"]),
+    help="Orientation of characters in the generated video: consistent with the image or video.",
+)
+@click.option(
+    "--mode",
+    type=click.Choice(KLING_MODES),
+    default=DEFAULT_MODE,
+    help="Generation mode: std (High performance) or pro (High quality).",
+)
+@click.option(
+    "--keep-original-sound/--no-keep-original-sound",
+    default=True,
+    help="Whether to keep the original sound from the reference video (default: keep).",
+)
+@click.option("--prompt", default=None, help="Text prompt (positive and/or negative descriptions).")
+@click.option("--callback-url", default=None, help="Webhook callback URL.")
+@click.option(
+    "--async",
+    "async_mode",
+    is_flag=True,
+    default=False,
+    help="Submit asynchronously; returns a task_id to poll instead of waiting.",
+)
+@click.option(
+    "--timeout", default=None, type=int, help="Timeout in seconds for the API to return data."
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def motion(
+    ctx: click.Context,
+    image_url: str,
+    video_url: str,
+    character_orientation: str | None,
+    mode: str,
+    keep_original_sound: bool,
+    prompt: str | None,
+    callback_url: str | None,
+    async_mode: bool,
+    timeout: int | None,
+    output_json: bool,
+) -> None:
+    """Generate a motion video from a reference image and reference video.
+
+    The generated video's characters and elements are based on the reference image,
+    while the movements are based on the reference video.
+
+    Examples:
+
+      kling motion --image-url https://example.com/img.jpg --video-url https://example.com/ref.mp4
+
+      kling motion --image-url img.jpg --video-url ref.mp4 --prompt "A dancer performing"
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.generate_motion(
+            image_url=image_url,
+            video_url=video_url,
+            character_orientation=character_orientation,
+            mode=mode,
+            keep_original_sound="yes" if keep_original_sound else "no",
+            prompt=prompt,
+            callback_url=callback_url,
+            **({"async": True} if async_mode else {}),
+            timeout=timeout,
+        )
+        if output_json:
+            print_json(result)
+        else:
+            print_video_result(result)
+    except KlingError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e