Metadata-Version: 2.5
Name: visionstory-cli
Version: 0.0.5
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.5
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 contract
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 --output speech.mp3
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>.

`visionstory contract` requires no API key and prints the OpenAPI contract version, SHA-256
fingerprint, and operation count shared by the SDK and MCP package.

## License

MIT
