visionstory-cli 0.0.1__tar.gz

visionstory_cli-0.0.1/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/

visionstory_cli-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VisionStory
+
+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.

visionstory_cli-0.0.1/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.5
+Name: visionstory-cli
+Version: 0.0.1
+Summary: Command-line interface for the VisionStory API - AI talking-avatar video generation.
+Project-URL: Homepage, https://openapi.visionstory.ai/docs
+Project-URL: Documentation, https://openapi.visionstory.ai/docs/guides/cli
+Author-email: VisionStory <register@visionstory.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,avatar,cli,command-line,talking-avatar,video-generation,visionstory
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: visionstory>=0.0.2
+Description-Content-Type: text/markdown
+
+# VisionStory CLI
+
+Command-line interface for the [VisionStory API](https://openapi.visionstory.ai/docs) — generate AI talking-avatar videos, clone voices, run text-to-speech, image, and AI (Seedance) video, all from your terminal.
+
+- **Covers the whole API** — every list, create, query, and delete operation has a subcommand.
+- **JSON in, JSON out** — prints the API response to stdout; composes with `jq` and shell scripts.
+- Thin wrapper over the [`visionstory`](https://pypi.org/project/visionstory/) SDK — same auth, same API.
+
+## Install
+
+```bash
+pip install visionstory-cli
+```
+
+This installs the `visionstory` command (and pulls in the `visionstory` SDK). For the Python library on its own, install [`visionstory`](https://pypi.org/project/visionstory/); for the MCP server, [`visionstory-mcp`](https://pypi.org/project/visionstory-mcp/).
+
+## Quick start
+
+```bash
+export VISIONSTORY_API_KEY="sk-vs-xxxxxxxxxxxxxxxxxxx"
+
+visionstory avatars
+visionstory voices
+visionstory create-video --avatar-id 4321918387609092991 --text "Hello from VisionStory." --voice-id Alice --output result.mp4
+visionstory status --video-id 7241059991822401536
+```
+
+The API key is read from `VISIONSTORY_API_KEY` and never passed as a flag. `create-video` and `create-ai-video` block until the video is ready and download it with `--output`; add `--no-wait` to return immediately.
+
+## Commands
+
+```bash
+# Discover
+visionstory models | avatars | voices | credits | videos | assets
+
+# Talking-avatar video
+visionstory create-video --avatar-id <id> --text "..." --voice-id Alice --output result.mp4
+visionstory status --video-id <id>
+
+# Avatars / voices / assets
+visionstory create-avatar --image-url <url>
+visionstory clone-voice --audio-url <url>
+visionstory upload-asset --url <url>
+
+# Text-to-speech, image, AI (Seedance) video
+visionstory tts --text "..." --voice-id Alice
+visionstory create-image --model-id <model> --prompt "..."
+visionstory ai-video-cost --model-id seedance-2.0 --duration-sec 8
+visionstory create-ai-video --model-id seedance-2.0 --prompt "..." --output ai.mp4
+
+# Delete
+visionstory delete-video --video-id <id>
+```
+
+Run `visionstory --help` or `visionstory <command> --help` for every command and flag. Full guide: <https://openapi.visionstory.ai/docs/guides/cli>.
+
+## License
+
+MIT

visionstory_cli-0.0.1/README.md

@@ -0,0 +1,59 @@
+# VisionStory CLI
+
+Command-line interface for the [VisionStory API](https://openapi.visionstory.ai/docs) — generate AI talking-avatar videos, clone voices, run text-to-speech, image, and AI (Seedance) video, all from your terminal.
+
+- **Covers the whole API** — every list, create, query, and delete operation has a subcommand.
+- **JSON in, JSON out** — prints the API response to stdout; composes with `jq` and shell scripts.
+- Thin wrapper over the [`visionstory`](https://pypi.org/project/visionstory/) SDK — same auth, same API.
+
+## Install
+
+```bash
+pip install visionstory-cli
+```
+
+This installs the `visionstory` command (and pulls in the `visionstory` SDK). For the Python library on its own, install [`visionstory`](https://pypi.org/project/visionstory/); for the MCP server, [`visionstory-mcp`](https://pypi.org/project/visionstory-mcp/).
+
+## Quick start
+
+```bash
+export VISIONSTORY_API_KEY="sk-vs-xxxxxxxxxxxxxxxxxxx"
+
+visionstory avatars
+visionstory voices
+visionstory create-video --avatar-id 4321918387609092991 --text "Hello from VisionStory." --voice-id Alice --output result.mp4
+visionstory status --video-id 7241059991822401536
+```
+
+The API key is read from `VISIONSTORY_API_KEY` and never passed as a flag. `create-video` and `create-ai-video` block until the video is ready and download it with `--output`; add `--no-wait` to return immediately.
+
+## Commands
+
+```bash
+# Discover
+visionstory models | avatars | voices | credits | videos | assets
+
+# Talking-avatar video
+visionstory create-video --avatar-id <id> --text "..." --voice-id Alice --output result.mp4
+visionstory status --video-id <id>
+
+# Avatars / voices / assets
+visionstory create-avatar --image-url <url>
+visionstory clone-voice --audio-url <url>
+visionstory upload-asset --url <url>
+
+# Text-to-speech, image, AI (Seedance) video
+visionstory tts --text "..." --voice-id Alice
+visionstory create-image --model-id <model> --prompt "..."
+visionstory ai-video-cost --model-id seedance-2.0 --duration-sec 8
+visionstory create-ai-video --model-id seedance-2.0 --prompt "..." --output ai.mp4
+
+# Delete
+visionstory delete-video --video-id <id>
+```
+
+Run `visionstory --help` or `visionstory <command> --help` for every command and flag. Full guide: <https://openapi.visionstory.ai/docs/guides/cli>.
+
+## License
+
+MIT

visionstory_cli-0.0.1/pyproject.toml

@@ -0,0 +1,46 @@
+# Packaging config for the VisionStory CLI — the `visionstory` command.
+# A thin wrapper over the published `visionstory` SDK, kept as a separate package
+# so `pip install visionstory` stays a pure library and the CLI is opt-in.
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "visionstory-cli"
+version = "0.0.1"
+description = "Command-line interface for the VisionStory API - AI talking-avatar video generation."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "VisionStory", email = "register@visionstory.ai" }]
+keywords = ["visionstory", "cli", "command-line", "avatar", "talking-avatar", "video-generation", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "visionstory>=0.0.2",
+]
+
+[project.scripts]
+visionstory = "visionstory_cli:main"
+
+[project.urls]
+Homepage = "https://openapi.visionstory.ai/docs"
+Documentation = "https://openapi.visionstory.ai/docs/guides/cli"
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/README.md", "/LICENSE", "/pyproject.toml"]   # ship only what's needed
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/visionstory_cli"]

visionstory_cli-0.0.1/src/visionstory_cli/__init__.py

@@ -0,0 +1,10 @@
+"""VisionStory CLI package.
+
+Installs the ``visionstory`` command (``pip install visionstory-cli``). Every
+subcommand is a thin wrapper over the ``visionstory`` SDK — same auth, same API.
+Run ``visionstory --help`` or ``python -m visionstory_cli --help``.
+"""
+from visionstory_cli.cli import build_parser, main
+
+__all__ = ["build_parser", "main"]
+__version__ = "0.0.1"

visionstory_cli-0.0.1/src/visionstory_cli/__main__.py

@@ -0,0 +1,5 @@
+"""``python -m visionstory_cli`` entry point."""
+from visionstory_cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

visionstory_cli-0.0.1/src/visionstory_cli/cli.py

@@ -0,0 +1,330 @@
+"""``visionstory`` command-line interface.
+
+Installed as the ``visionstory`` console command by ``pip install visionstory``.
+Zero third-party dependencies (Python standard library + this package). Every
+subcommand maps 1:1 to a :class:`~visionstory.VisionStoryClient` method, so the
+CLI covers the same surface as the SDK: talking-avatar videos, avatars, voices,
+assets, text-to-speech, image generation, and AI (Seedance) video.
+
+The API key is read from the ``VISIONSTORY_API_KEY`` environment variable and is
+never accepted as a command-line argument. Run ``visionstory --help`` or
+``visionstory <command> --help`` for the full option list.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Any
+
+from visionstory import VisionStoryAPIError, VisionStoryClient, build_video_payload
+from visionstory._core import API_KEY_ENV, BASE_URL_ENV, DEFAULT_BASE_URL
+
+# Read-only list commands (no args) -> client method
+_LIST_COMMANDS = {
+    "models": "list_models",
+    "avatars": "list_avatars",
+    "voices": "list_voices",
+    "videos": "list_videos",
+    "credits": "get_credits",
+    "image-models": "list_image_models",
+    "ai-video-models": "list_ai_video_models",
+}
+
+# Delete commands -> (client method, argument dest)
+_DELETE_COMMANDS = {
+    "delete-video": ("delete_video", "video_id"),
+    "delete-avatar": ("delete_avatar", "avatar_id"),
+    "delete-voice": ("delete_voice", "voice_id"),
+    "delete-asset": ("delete_asset", "asset_id"),
+    "delete-ai-video": ("delete_ai_video", "video_id"),
+}
+
+
+def _print_json(data: Any) -> None:
+    print(json.dumps(data, ensure_ascii=False, indent=2))
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="visionstory", description="VisionStory API command-line client")
+    parser.add_argument(
+        "--base-url",
+        default=os.getenv(BASE_URL_ENV, DEFAULT_BASE_URL),
+        help=f"API base URL (defaults to ${BASE_URL_ENV} or {DEFAULT_BASE_URL})",
+    )
+    parser.add_argument("--request-timeout", type=int, default=60, help="Per-request timeout in seconds")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    for name in _LIST_COMMANDS:
+        sub.add_parser(name, help="Show remaining credits" if name == "credits" else f"List {name.replace('-', ' ')}")
+
+    for name, (_method, dest) in _DELETE_COMMANDS.items():
+        p = sub.add_parser(name, help=f"Delete a {name.split('-', 1)[1].replace('-', ' ')}")
+        p.add_argument("--" + dest.replace("_", "-"), dest=dest, required=True)
+
+    # ---- avatars / voices / assets --------------------------------------
+    avatar = sub.add_parser("create-avatar", help="Create an avatar from an image")
+    src = avatar.add_mutually_exclusive_group(required=True)
+    src.add_argument("--image", type=Path, help="Local image file")
+    src.add_argument("--image-url", help="Public image URL")
+
+    clone = sub.add_parser("clone-voice", help="Clone a voice from an audio sample")
+    clone_src = clone.add_mutually_exclusive_group(required=True)
+    clone_src.add_argument("--audio-file", type=Path, help="Local audio file")
+    clone_src.add_argument("--audio-url", help="Public audio URL")
+    clone.add_argument("--preview-text", help="Optional text to preview the cloned voice")
+
+    upload = sub.add_parser("upload-asset", help="Upload a reusable media asset")
+    upload_src = upload.add_mutually_exclusive_group(required=True)
+    upload_src.add_argument("--file", type=Path, dest="file_path", help="Local media file")
+    upload_src.add_argument("--url", help="Public media URL")
+
+    assets = sub.add_parser("assets", help="List your uploaded assets")
+    assets.add_argument("--kind", choices=("image", "video", "audio"), help="Filter by asset kind")
+    assets.add_argument("--cursor")
+    assets.add_argument("--limit", type=int)
+
+    # ---- talking-avatar video -------------------------------------------
+    video = sub.add_parser("create-video", help="Create a talking-avatar video")
+    video.add_argument("--avatar-id", required=True)
+    script = video.add_mutually_exclusive_group(required=True)
+    script.add_argument("--text", help="Text script to speak")
+    script.add_argument("--audio-file", type=Path, help="Local audio file to drive the avatar")
+    script.add_argument("--audio-url", help="Public audio URL to drive the avatar")
+    video.add_argument("--voice-id", default="Alice", help="Voice id from `visionstory voices`")
+    video.add_argument("--speech-rate", default="normal")
+    video.add_argument("--model-id", default="vs_character_v4", help="Model id from `visionstory models`")
+    video.add_argument("--aspect-ratio", default="9:16")
+    video.add_argument("--resolution", default="720p")
+    video.add_argument("--emotion", default="cheerful")
+    video.add_argument("--background-color", default="")
+    video.add_argument("--voice-change", action="store_true")
+    video.add_argument("--denoise", action="store_true")
+    video.add_argument("--client-request-id", help="Idempotency key (same value within 24h returns the original task)")
+    video.add_argument("--no-wait", action="store_true", help="Return immediately instead of polling to completion")
+    video.add_argument("--poll-interval", type=float, default=5)
+    video.add_argument("--timeout", type=int, default=600)
+    video.add_argument("--output", type=Path, help="Download the finished video to this path")
+
+    status = sub.add_parser("status", help="Query one talking-avatar video task")
+    status.add_argument("--video-id", required=True)
+
+    download = sub.add_parser("download", help="Download a media URL to a file")
+    download.add_argument("--url", required=True)
+    download.add_argument("--output", required=True, type=Path)
+
+    # ---- text to speech --------------------------------------------------
+    tts = sub.add_parser("tts", help="Synthesize speech from text")
+    tts.add_argument("--text", required=True)
+    tts.add_argument("--voice-id", required=True, help="Voice id from `visionstory voices`")
+
+    # ---- image generation ------------------------------------------------
+    image = sub.add_parser("create-image", help="Generate an image from a prompt")
+    image.add_argument("--model-id", help="Model id from `visionstory image-models` (required unless --json)")
+    image.add_argument("--prompt", help="Text prompt (required unless --json)")
+    image.add_argument("--aspect-ratio")
+    image.add_argument("--resolution")
+    image.add_argument("--ref-url", action="append", metavar="URL", help="Reference image URL (repeatable)")
+    image.add_argument("--json", help="Full request body as JSON (overrides the field flags)")
+
+    # ---- AI (Seedance) video --------------------------------------------
+    aiv = sub.add_parser("create-ai-video", help="Generate an AI (Seedance) video")
+    aiv.add_argument("--model-id", help="Model id from `visionstory ai-video-models` (required unless --json)")
+    aiv.add_argument("--prompt", help="Text prompt (required unless --json)")
+    aiv.add_argument("--duration-sec", type=int)
+    aiv.add_argument("--aspect-ratio")
+    aiv.add_argument("--resolution")
+    ga = aiv.add_mutually_exclusive_group()
+    ga.add_argument("--generate-audio", dest="generate_audio", action="store_true", default=None)
+    ga.add_argument("--no-generate-audio", dest="generate_audio", action="store_false")
+    aiv.add_argument("--first-frame-url", help="Image URL for image-to-video first frame")
+    aiv.add_argument("--end-frame-url", help="Image URL for the last frame (requires --first-frame-url)")
+    aiv.add_argument("--ref-url", action="append", metavar="URL", help="Reference media URL (repeatable)")
+    aiv.add_argument("--client-request-id")
+    aiv.add_argument("--json", help="Full request body as JSON (overrides the field flags)")
+    aiv.add_argument("--no-wait", action="store_true", help="Return immediately instead of polling to completion")
+    aiv.add_argument("--poll-interval", type=float, default=5)
+    aiv.add_argument("--timeout", type=int, default=600)
+    aiv.add_argument("--output", type=Path, help="Download the finished video to this path")
+
+    aiv_status = sub.add_parser("ai-video-status", help="Query one or more AI video tasks")
+    aiv_status_src = aiv_status.add_mutually_exclusive_group(required=True)
+    aiv_status_src.add_argument("--video-id")
+    aiv_status_src.add_argument("--video-ids", help="Comma-separated ids for a batch query")
+
+    aiv_list = sub.add_parser("ai-videos", help="List your AI video tasks")
+    aiv_list.add_argument("--cursor")
+    aiv_list.add_argument("--limit", type=int)
+
+    aiv_cost = sub.add_parser("ai-video-cost", help="Credit cost of an AI video before submitting")
+    aiv_cost.add_argument("--model-id", required=True)
+    aiv_cost.add_argument("--duration-sec", type=int, required=True)
+    aiv_cost.add_argument("--resolution")
+    aiv_cost.add_argument("--generate-audio", dest="generate_audio", action="store_true", default=None)
+
+    return parser
+
+
+def _talking_video_payload(args: argparse.Namespace) -> dict[str, Any]:
+    payload = build_video_payload(
+        avatar_id=args.avatar_id,
+        text=args.text,
+        audio_url=args.audio_url,
+        audio_file=args.audio_file,
+        voice_id=args.voice_id,
+        speech_rate=args.speech_rate,
+        model_id=args.model_id,
+        aspect_ratio=args.aspect_ratio,
+        resolution=args.resolution,
+        emotion=args.emotion,
+        background_color=args.background_color,
+        voice_change=args.voice_change,
+        denoise=args.denoise,
+    )
+    if args.client_request_id:
+        payload["client_request_id"] = args.client_request_id
+    return payload
+
+
+def _ai_video_payload(args: argparse.Namespace) -> dict[str, Any]:
+    if args.json:
+        return json.loads(args.json)
+    if not args.model_id or not args.prompt:
+        raise ValueError("create-ai-video requires --model-id and --prompt (or --json)")
+    payload: dict[str, Any] = {"model_id": args.model_id, "prompt": args.prompt}
+    if args.duration_sec is not None:
+        payload["duration_sec"] = args.duration_sec
+    if args.aspect_ratio is not None:
+        payload["aspect_ratio"] = args.aspect_ratio
+    if args.resolution is not None:
+        payload["resolution"] = args.resolution
+    if args.generate_audio is not None:
+        payload["generate_audio"] = args.generate_audio
+    if args.first_frame_url:
+        payload["first_frame"] = {"url": args.first_frame_url}
+    if args.end_frame_url:
+        payload["end_frame"] = {"url": args.end_frame_url}
+    if args.ref_url:
+        payload["refs"] = [{"url": u} for u in args.ref_url]
+    if args.client_request_id:
+        payload["client_request_id"] = args.client_request_id
+    return payload
+
+
+def _image_payload(args: argparse.Namespace) -> dict[str, Any]:
+    if args.json:
+        return json.loads(args.json)
+    if not args.model_id or not args.prompt:
+        raise ValueError("create-image requires --model-id and --prompt (or --json)")
+    payload: dict[str, Any] = {"model_id": args.model_id, "prompt": args.prompt}
+    if args.aspect_ratio is not None:
+        payload["aspect_ratio"] = args.aspect_ratio
+    if args.resolution is not None:
+        payload["resolution"] = args.resolution
+    if args.ref_url:
+        payload["refs"] = [{"url": u} for u in args.ref_url]
+    return payload
+
+
+def _run(args: argparse.Namespace) -> Any:
+    # Pure argument-combination checks: before key/network, so bad usage is caught even without a key
+    if getattr(args, "no_wait", False) and getattr(args, "output", None) is not None:
+        raise ValueError("--output requires waiting for the video; remove --no-wait")
+
+    # download needs no API key (fetches the URL directly)
+    if args.command == "download":
+        VisionStoryClient.download(args.url, args.output, args.request_timeout)
+        return {"output": str(args.output)}
+
+    api_key = os.getenv(API_KEY_ENV)
+    if not api_key:
+        raise VisionStoryAPIError(
+            f"{API_KEY_ENV} is not set. Configure it in your environment "
+            "instead of passing the key on the command line."
+        )
+    client = VisionStoryClient(api_key, args.base_url, args.request_timeout)
+
+    if args.command in _LIST_COMMANDS:
+        return getattr(client, _LIST_COMMANDS[args.command])()
+
+    if args.command in _DELETE_COMMANDS:
+        method, dest = _DELETE_COMMANDS[args.command]
+        return getattr(client, method)(getattr(args, dest))
+
+    if args.command == "create-avatar":
+        return client.create_avatar(image_url=args.image_url, image_file=args.image)
+
+    if args.command == "clone-voice":
+        return client.clone_voice(audio_url=args.audio_url, audio_file=args.audio_file,
+                                  preview_text=args.preview_text)
+
+    if args.command == "upload-asset":
+        return client.upload_asset(url=args.url, file_path=args.file_path)
+
+    if args.command == "assets":
+        return client.list_assets(kind=args.kind, cursor=args.cursor, limit=args.limit)
+
+    if args.command == "status":
+        return client.get_video(args.video_id)
+
+    if args.command == "create-video":
+        video = client.generate_video(
+            _talking_video_payload(args),
+            wait=not args.no_wait, poll_interval=args.poll_interval, timeout=args.timeout,
+        )
+        if not args.no_wait and args.output is not None:
+            url = video.get("video_url")
+            if not url:
+                raise VisionStoryAPIError("Finished video has no video_url")
+            client.download(url, args.output, args.request_timeout)
+            video["output"] = str(args.output)
+        return video
+
+    if args.command == "tts":
+        return client.create_speech(text=args.text, voice_id=args.voice_id)
+
+    if args.command == "create-image":
+        return client.create_image(_image_payload(args))
+
+    if args.command == "create-ai-video":
+        video = client.generate_ai_video(
+            _ai_video_payload(args),
+            wait=not args.no_wait, poll_interval=args.poll_interval, timeout=args.timeout,
+        )
+        if not args.no_wait and args.output is not None:
+            url = video.get("video_url")
+            if not url:
+                raise VisionStoryAPIError("Finished AI video has no video_url")
+            client.download(url, args.output, args.request_timeout)
+            video["output"] = str(args.output)
+        return video
+
+    if args.command == "ai-video-status":
+        if args.video_id:
+            return client.get_ai_video(args.video_id)
+        return client.get_ai_video(video_ids=args.video_ids)
+
+    if args.command == "ai-videos":
+        return client.list_ai_videos(cursor=args.cursor, limit=args.limit)
+
+    if args.command == "ai-video-cost":
+        return client.ai_video_cost(model_id=args.model_id, duration_sec=args.duration_sec,
+                                    resolution=args.resolution, generate_audio=args.generate_audio)
+
+    raise ValueError(f"Unsupported command: {args.command}")
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    try:
+        _print_json(_run(args))
+        return 0
+    except (OSError, TimeoutError, ValueError, VisionStoryAPIError, json.JSONDecodeError) as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())