Visla Video Generation

Version: 260501-1423

Create AI-generated videos from text scripts, web URLs, or documents (PPT/PDF) using Visla's OpenAPI.

Before You Start

Credentials (NEVER output API keys/secrets in responses):

IMPORTANT: Never output API keys/secrets in responses.

1. Check if ~/.config/visla/.credentials exists (do NOT read it yet).
2. If the file exists, use a choice-based confirmation to ask the user:

"Found saved credentials. Allow reading ~/.config/visla/.credentials?"

Options: Allow / No

1. If the user selects Allow: proceed with the command.
2. If the user selects No, or the file does not exist:

Ask the user to provide credentials via one of:

• Environment variables (VISLA_API_KEY, VISLA_API_SECRET)
• CLI arguments (--key, --secret)
• Direct input of API key and secret

1. If provided credentials fail with VISLA_CLI_ERROR_CODE=missing_credentials or

VISLA_CLI_ERROR_CODE=auth_failed, ask the user to re-enter valid credentials.

Only process local files (scripts/docs) explicitly provided by the user, and remind users to avoid uploading sensitive

data.

• Tell the user: this is a one-time setup (once configured, they won't need to do this again)
• Tell the user: get API Key and Secret from https://www.visla.us/visla-api
• Do not repeat the secrets back in the response.

Credential validity check (practical):

• If credentials exist but running account fails with VISLA_CLI_ERROR_CODE=missing_credentials or

VISLA_CLI_ERROR_CODE=auth_failed, treat credentials as invalid and ask the user to provide real ones.

File format (bash/zsh):

export VISLA_API_KEY="your_key"
export VISLA_API_SECRET="your_secret"

For PowerShell (temporary session):

$env:VISLA_API_KEY = "your_key"
$env:VISLA_API_SECRET = "your_secret"

Scripts: scripts/visla_cli.py (Python), scripts/visla_cli.sh (Bash)

Platform Execution

Default strategy:

• Prefer Bash on macOS when dependencies are available (the Bash CLI avoids Python SSL-stack issues on some macOS

setups).

• Prefer Python when you're already using a well-configured Python (or when Bash dependencies are missing).

Bash (recommended on macOS; also works on Linux-like environments):

# With user consent, you may source ~/.config/visla/.credentials
export VISLA_API_KEY="your_key"
export VISLA_API_SECRET="your_secret"
./scripts/visla_cli.sh <command>

Python (cross-platform):

python3 scripts/visla_cli.py --key "your_key" --secret "your_secret" <command>
# Or, credentials are auto-detected from ~/.config/visla/.credentials (with user consent):
python3 scripts/visla_cli.py <command>

Windows native (PowerShell/CMD without Bash; Python):

# PowerShell
$env:VISLA_API_KEY = "your_key"
$env:VISLA_API_SECRET = "your_secret"
python scripts/visla_cli.py <command>

Windows note:

• The agent should prefer running the Python CLI on Windows unless it has verified a Bash environment (WSL/Git Bash)

is available.

• For simple scripts, pass directly: python scripts/visla_cli.py script "Scene 1: ..."
• For multi-line or complex scripts, use stdin with - (recommended, no temp files):

```powershell

@"

Scene 1: ...

Scene 2: ...

"@ | python scripts/visla_cli.py script -

```

• If you have Python Launcher installed, py -3 scripts/visla_cli.py may work better than python.
• Credentials:
• The Python CLI auto-detects ~/.config/visla/.credentials when present.
• On Windows the default path is typically: %USERPROFILE%\\.config\\visla\\.credentials.

Note: do not print credentials. Prefer environment variables or auto-detected credentials with explicit user consent.

Commands

Important: For avatar and voice commands:

• Run the full CLI command (./visla_cli.sh avatar or ./visla_cli.sh voice).
• You may filter the output before presenting to the user:
• For avatar: remove Thumbnail: lines
• For voice: remove URL: lines
• Categorize and format avatar results as follows:
• Group avatars by gender category (Female, Male, Neutral, Dynamic)
• List each avatar name with (n) where n = number of looks
• For each look, show: Look Name (lookUuid)
• Format: - AvatarName (n): Look1 (uuid), Look2 (uuid), ...
• Example:

```

Female (16):

• Emma (5): Blue Dress (1000145), Patterned Dress (1000146), Black Blazer (1000147), Light Gray Blazer (1000148), Emerald Green Pantsuit (1000149)

```

• Categorize voice results by language/region (e.g., System, US English, Chinese, Japanese, French, etc.)
• You must NOT omit any items from the list. The user must see all available avatars/voices, even if the list is long.
• Agents must use the exact ID from the listing when configuring videos.

Optional Parameters

visual command specific