hailuo-cli 2026.7.31.0__tar.gz

hailuo_cli-2026.7.31.0/.env.example

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

hailuo_cli-2026.7.31.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/

hailuo_cli-2026.7.31.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Calendar Versioning](https://calver.org/) (YYYY.MM.DD.BUILD).
+
+## [0.1.0] - 2026-04-26
+
+### Added
+- Initial release
+- Hailuo video generation from text prompts (minimax-t2v)
+- Image-to-video generation (minimax-i2v, minimax-i2v-director)
+- Task management with polling
+- Rich terminal output with tables and panels
+- JSON output mode (`--json` flag)
+- Multiple model support

hailuo_cli-2026.7.31.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.

hailuo_cli-2026.7.31.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.1
+Name: hailuo-cli
+Version: 2026.7.31.0
+Summary: CLI tool for Hailuo AI Video Generation via AceDataCloud API
+Project-URL: Homepage, https://github.com/AceDataCloud/HailuoCli
+Project-URL: Repository, https://github.com/AceDataCloud/HailuoCli
+Project-URL: Issues, https://github.com/AceDataCloud/HailuoCli/issues
+Project-URL: Changelog, https://github.com/AceDataCloud/HailuoCli/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,hailuo,minimax,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: hailuo-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
+
+# Hailuo CLI
+
+A command-line tool for generating AI videos using [Hailuo (MiniMax)](https://platform.acedata.cloud) through the AceDataCloud platform.
+
+## Installation
+
+```bash
+pip install hailuo-cli
+```
+
+## Configuration
+
+```bash
+export ACEDATACLOUD_API_TOKEN=your_token
+```
+
+Or copy `.env.example` to `.env` and fill in your token.
+
+## Commands
+
+### Video Generation
+
+| Command | Description |
+|---------|-------------|
+| `hailuo generate <prompt>` | Generate a video from text (minimax-t2v) |
+| `hailuo image-to-video <prompt> --image-url <url>` | Generate video from image + text |
+
+### Task Management
+
+| Command | Description |
+|---------|-------------|
+| `hailuo task <task_id>` | Query a single task status |
+| `hailuo tasks <id1> <id2> [...]` | Query multiple tasks at once |
+| `hailuo wait <task_id>` | Wait for task completion with polling |
+
+### Utilities
+
+| Command | Description |
+|---------|-------------|
+| `hailuo models` | List available Hailuo models |
+| `hailuo config` | Show current configuration |
+
+## Global Options
+
+```
+--token TEXT    API token (or set ACEDATACLOUD_API_TOKEN env var)
+--version       Show version
+--help          Show help message
+```
+
+Most commands support:
+
+```
+--json          Output raw JSON (for piping/scripting)
+--callback-url  Webhook URL for async notifications
+```
+
+## Examples
+
+```bash
+# Generate a video from a text prompt
+hailuo generate "A cat playing in the snow"
+
+# Generate from image reference
+hailuo image-to-video "Animate the scene" --image-url https://example.com/photo.jpg
+
+# Use a specific model
+hailuo generate "Ocean waves" --model minimax-t2v
+
+# Director model with image reference
+hailuo image-to-video "Cinematic pan" --image-url img.jpg --model minimax-i2v-director
+
+# Check task status
+hailuo task abc123-def456
+
+# Wait for completion
+hailuo wait abc123 --timeout 300
+```
+
+## Docker
+
+```bash
+# Pull the image
+docker pull ghcr.io/acedatacloud/hailuo-cli:latest
+
+# Run a command
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/hailuo-cli generate "A happy scene"
+
+# Or use docker-compose
+docker compose run --rm hailuo-cli generate "A happy scene"
+```
+
+## Project Structure
+
+```
+HailuoCli/
+├── hailuo_cli/             # Main package
+│   ├── __init__.py
+│   ├── __main__.py         # python -m hailuo_cli entry point
+│   ├── main.py             # CLI entry point
+│   ├── core/               # Core modules
+│   │   ├── client.py       # HTTP client for Hailuo API
+│   │   ├── config.py       # Configuration management
+│   │   ├── exceptions.py   # Custom exceptions
+│   │   └── output.py       # Rich terminal formatting
+│   └── commands/           # CLI command groups
+│       ├── video.py        # Video generation commands
+│       ├── task.py         # Task management commands
+│       └── info.py         # Info and utility commands
+└── tests/                  # Test suite
+```
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

hailuo_cli-2026.7.31.0/README.md

@@ -0,0 +1,116 @@
+# Hailuo CLI
+
+A command-line tool for generating AI videos using [Hailuo (MiniMax)](https://platform.acedata.cloud) through the AceDataCloud platform.
+
+## Installation
+
+```bash
+pip install hailuo-cli
+```
+
+## Configuration
+
+```bash
+export ACEDATACLOUD_API_TOKEN=your_token
+```
+
+Or copy `.env.example` to `.env` and fill in your token.
+
+## Commands
+
+### Video Generation
+
+| Command | Description |
+|---------|-------------|
+| `hailuo generate <prompt>` | Generate a video from text (minimax-t2v) |
+| `hailuo image-to-video <prompt> --image-url <url>` | Generate video from image + text |
+
+### Task Management
+
+| Command | Description |
+|---------|-------------|
+| `hailuo task <task_id>` | Query a single task status |
+| `hailuo tasks <id1> <id2> [...]` | Query multiple tasks at once |
+| `hailuo wait <task_id>` | Wait for task completion with polling |
+
+### Utilities
+
+| Command | Description |
+|---------|-------------|
+| `hailuo models` | List available Hailuo models |
+| `hailuo config` | Show current configuration |
+
+## Global Options
+
+```
+--token TEXT    API token (or set ACEDATACLOUD_API_TOKEN env var)
+--version       Show version
+--help          Show help message
+```
+
+Most commands support:
+
+```
+--json          Output raw JSON (for piping/scripting)
+--callback-url  Webhook URL for async notifications
+```
+
+## Examples
+
+```bash
+# Generate a video from a text prompt
+hailuo generate "A cat playing in the snow"
+
+# Generate from image reference
+hailuo image-to-video "Animate the scene" --image-url https://example.com/photo.jpg
+
+# Use a specific model
+hailuo generate "Ocean waves" --model minimax-t2v
+
+# Director model with image reference
+hailuo image-to-video "Cinematic pan" --image-url img.jpg --model minimax-i2v-director
+
+# Check task status
+hailuo task abc123-def456
+
+# Wait for completion
+hailuo wait abc123 --timeout 300
+```
+
+## Docker
+
+```bash
+# Pull the image
+docker pull ghcr.io/acedatacloud/hailuo-cli:latest
+
+# Run a command
+docker run --rm -e ACEDATACLOUD_API_TOKEN=your_token \
+  ghcr.io/acedatacloud/hailuo-cli generate "A happy scene"
+
+# Or use docker-compose
+docker compose run --rm hailuo-cli generate "A happy scene"
+```
+
+## Project Structure
+
+```
+HailuoCli/
+├── hailuo_cli/             # Main package
+│   ├── __init__.py
+│   ├── __main__.py         # python -m hailuo_cli entry point
+│   ├── main.py             # CLI entry point
+│   ├── core/               # Core modules
+│   │   ├── client.py       # HTTP client for Hailuo API
+│   │   ├── config.py       # Configuration management
+│   │   ├── exceptions.py   # Custom exceptions
+│   │   └── output.py       # Rich terminal formatting
+│   └── commands/           # CLI command groups
+│       ├── video.py        # Video generation commands
+│       ├── task.py         # Task management commands
+│       └── info.py         # Info and utility commands
+└── tests/                  # Test suite
+```
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

hailuo_cli-2026.7.31.0/hailuo_cli/__init__.py

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

hailuo_cli-2026.7.31.0/hailuo_cli/__main__.py

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

hailuo_cli-2026.7.31.0/hailuo_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""Commands package for Hailuo CLI."""

hailuo_cli-2026.7.31.0/hailuo_cli/commands/info.py

@@ -0,0 +1,30 @@
+"""Info and utility commands."""
+
+import click
+
+from hailuo_cli.core.config import settings
+from hailuo_cli.core.output import console, print_models
+
+
+@click.command()
+def models() -> None:
+    """List available Hailuo models."""
+    print_models()
+
+
+@click.command()
+def config() -> None:
+    """Show current configuration."""
+    from rich.table import Table
+
+    table = Table(title="Hailuo 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)

hailuo_cli-2026.7.31.0/hailuo_cli/commands/task.py

@@ -0,0 +1,160 @@
+"""Task management commands."""
+
+import time
+
+import click
+
+from hailuo_cli.core.client import get_client
+from hailuo_cli.core.exceptions import HailuoError
+from hailuo_cli.core.output import (
+    print_error,
+    print_json,
+    print_success,
+    print_task_result,
+)
+
+
+@click.command()
+@click.argument("task_id")
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def task(
+    ctx: click.Context,
+    task_id: str,
+    output_json: bool,
+) -> None:
+    """Query a single task status.
+
+    TASK_ID is the task ID returned from generate commands.
+
+    \b
+    Examples:
+      hailuo task abc123-def456
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(id=task_id, action="retrieve")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except HailuoError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("tasks")
+@click.argument("task_ids", nargs=-1, required=True)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def tasks_batch(
+    ctx: click.Context,
+    task_ids: tuple[str, ...],
+    output_json: bool,
+) -> None:
+    """Query multiple tasks at once.
+
+    TASK_IDS are space-separated task IDs.
+
+    \b
+    Examples:
+      hailuo tasks abc123 def456 ghi789
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        result = client.query_task(ids=list(task_ids), action="retrieve_batch")
+        if output_json:
+            print_json(result)
+        else:
+            print_task_result(result)
+    except HailuoError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command()
+@click.argument("task_id")
+@click.option(
+    "--interval",
+    type=int,
+    default=5,
+    help="Polling interval in seconds (default: 5).",
+)
+@click.option(
+    "--timeout",
+    "max_timeout",
+    type=int,
+    default=600,
+    help="Maximum wait time in seconds (default: 600).",
+)
+@click.option("--json", "output_json", is_flag=True, help="Output raw JSON.")
+@click.pass_context
+def wait(
+    ctx: click.Context,
+    task_id: str,
+    interval: int,
+    max_timeout: int,
+    output_json: bool,
+) -> None:
+    """Wait for a task to complete, polling periodically.
+
+    TASK_ID is the task ID to monitor.
+
+    \b
+    Examples:
+      hailuo wait abc123
+      hailuo wait abc123 --interval 10 --timeout 300
+    """
+    client = get_client(ctx.obj.get("token"))
+    elapsed = 0
+
+    try:
+        while elapsed < max_timeout:
+            result = client.query_task(id=task_id, action="retrieve")
+
+            # Check for completion signals
+            data = result.get("data", result)
+            if isinstance(data, dict):
+                item = data
+            elif isinstance(data, list) and data:
+                item = data[0]
+            else:
+                item = result
+
+            state = item.get("state", item.get("status", ""))
+            video_url = item.get("video_url") or result.get("video_url")
+            error = item.get("error") or result.get("error")
+
+            if error:
+                if output_json:
+                    print_json(result)
+                else:
+                    print_error(f"Task {task_id} failed: {error}")
+                raise SystemExit(1)
+
+            if state in ("succeeded", "completed", "complete") or video_url:
+                if output_json:
+                    print_json(result)
+                else:
+                    print_success(f"Task {task_id} completed!")
+                    print_task_result(result)
+                return
+
+            if state in ("failed", "error"):
+                if output_json:
+                    print_json(result)
+                else:
+                    print_error(f"Task {task_id} failed.")
+                raise SystemExit(1)
+
+            if not output_json:
+                click.echo(f"Status: {state or 'pending'} (waited {elapsed}s)...", err=True)
+
+            time.sleep(interval)
+            elapsed += interval
+
+        print_error(f"Timeout: task {task_id} did not complete within {max_timeout}s")
+        raise SystemExit(1)
+    except HailuoError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

hailuo_cli-2026.7.31.0/hailuo_cli/commands/video.py

@@ -0,0 +1,128 @@
+"""Video generation commands."""
+
+import click
+
+from hailuo_cli.core.client import get_client
+from hailuo_cli.core.exceptions import HailuoError
+from hailuo_cli.core.output import (
+    DEFAULT_MODEL,
+    HAILUO_MODELS,
+    print_error,
+    print_json,
+    print_video_result,
+)
+
+
+@click.command()
+@click.argument("prompt")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(HAILUO_MODELS),
+    default=DEFAULT_MODEL,
+    help="Hailuo model to use (default: minimax-t2v).",
+)
+@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 generate(
+    ctx: click.Context,
+    prompt: str,
+    model: str,
+    callback_url: str | None,
+    async_mode: bool,
+    output_json: bool,
+) -> None:
+    """Generate a video from a text prompt.
+
+    PROMPT is a detailed description of what to generate.
+
+    \b
+    Examples:
+      hailuo generate "A cat playing in the snow"
+      hailuo generate "Ocean waves at sunset" --model minimax-t2v
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "action": "generate",
+            "prompt": prompt,
+            "model": model,
+            "callback_url": callback_url,
+            "async": async_mode,
+        }
+
+        result = client.generate_video(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_video_result(result)
+    except HailuoError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e
+
+
+@click.command("image-to-video")
+@click.argument("prompt")
+@click.option("--image-url", required=True, help="URL of the first frame reference image.")
+@click.option(
+    "-m",
+    "--model",
+    type=click.Choice(["minimax-i2v", "minimax-t2v", "minimax-i2v-director"]),
+    default="minimax-i2v",
+    help="Hailuo image-to-video model (default: minimax-i2v).",
+)
+@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 image_to_video(
+    ctx: click.Context,
+    prompt: str,
+    image_url: str,
+    model: str,
+    callback_url: str | None,
+    async_mode: bool,
+    output_json: bool,
+) -> None:
+    """Generate a video from an image and text prompt.
+
+    PROMPT describes the desired video content.
+
+    \b
+    Examples:
+      hailuo image-to-video "Animate this scene" --image-url https://example.com/photo.jpg
+      hailuo image-to-video "Cinematic pan" --image-url img.jpg --model minimax-i2v-director
+    """
+    client = get_client(ctx.obj.get("token"))
+    try:
+        payload: dict[str, object] = {
+            "action": "generate",
+            "prompt": prompt,
+            "model": model,
+            "first_image_url": image_url,
+            "callback_url": callback_url,
+            "async": async_mode,
+        }
+
+        result = client.generate_video(**payload)  # type: ignore[arg-type]
+        if output_json:
+            print_json(result)
+        else:
+            print_video_result(result)
+    except HailuoError as e:
+        print_error(e.message)
+        raise SystemExit(1) from e

hailuo_cli-2026.7.31.0/hailuo_cli/core/__init__.py

@@ -0,0 +1 @@
+"""Core package for Hailuo CLI."""