Visla 视频生成

版本：260501-1423

使用 Visla 的 OpenAPI，基于文本脚本、网页 URL 或文档（PPT/PDF）生成 AI 视频。

开始前准备

凭证（切勿在响应中输出 API 密钥/密钥）：

重要提示：切勿在响应中输出 API 密钥或密钥。

1. 检查 ~/.config/visla/.credentials 文件是否存在（此时请勿读取其内容）。
2. 若该文件存在，请使用基于选项的确认方式向用户提问： “已找到已保存的凭证。是否允许读取 ~/.config/visla/.credentials？” 可选操作：允许 / 否
3. 若用户选择允许，则继续执行命令。
4. 若用户选择否，或该文件不存在： 请提示用户提供凭证，方式如下之一：
   • 环境变量（VISLA_API_KEY、VISLA_API_SECRET）
   • CLI 参数（--key、--secret）
   • 直接输入 API 密钥和密钥
5. 若提供的凭证返回错误 VISLA_CLI_ERROR_CODE=missing_credentials 或 VISLA_CLI_ERROR_CODE=auth_failed，请提示用户重新输入有效凭证。

仅处理用户明确提供的本地文件（脚本/文档），并提醒用户避免上传敏感数据。

• 告知用户：这是一次性配置（完成配置后无需再次执行）
• 告知用户：API 密钥与密钥请从 https://www.visla.us/visla-api 获取
• 切勿在响应中重复输出密钥内容。

凭证有效性校验（实用方法）：

• 若凭证存在，但执行 account 命令失败并返回 VISLA_CLI_ERROR_CODE=missing_credentials 或 VISLA_CLI_ERROR_CODE=auth_failed，则视为凭证无效，并要求用户提供真实凭证。

文件格式（bash/zsh）：

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

PowerShell（临时会话）：

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

脚本：scripts/visla_cli.py（Python）、scripts/visla_cli.sh（Bash）

平台执行策略

默认策略：

• 在 macOS 上，若依赖项已就绪，优先使用Bash（Bash CLI 可规避部分 macOS 环境下的 Python SSL 栈问题）。
• 若已使用配置良好的 Python 环境（或 Bash 依赖缺失），则优先使用Python。

Bash（macOS 推荐；亦适用于类 Linux 环境）：

# 在获得用户许可后，可加载 ~/.config/visla/.credentials
export VISLA_API_KEY="your_key"
export VISLA_API_SECRET="your_secret"
./scripts/visla_cli.sh 

Python（跨平台）：

python3 scripts/visla_cli.py --key "your_key" --secret "your_secret" 
# 或者，在获得用户许可后，自动从 ~/.config/visla/.credentials 加载凭证：
python3 scripts/visla_cli.py 

Windows 原生环境（无 Bash 的 PowerShell/CMD；使用 Python）：

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

Windows 注意事项：

• 代理应优先在 Windows 上运行Python CLI，除非已确认 Bash 环境（WSL/Git Bash）可用。
• 对于简单脚本，可直接传入：python scripts/visla_cli.py script "Scene 1: ..."
• 对于多行或复杂脚本，推荐使用 stdin 方式（无需临时文件）：

  @"
  Scene 1: ...
  Scene 2: ...
  "@ | python scripts/visla_cli.py script -
  

• 若已安装 Python Launcher，py -3 scripts/visla_cli.py 可能比 python 更可靠。
• 凭证说明：
  • Python CLI 在检测到 ~/.config/visla/.credentials 时会自动加载。
  • 在 Windows 上，默认路径通常为：%USERPROFILE%\.config\visla\.credentials。

注意：切勿打印凭证。优先使用环境变量或经显式用户授权后自动检测的凭证。

命令列表

重要提示：针对 avatar 和 voice 命令：

• 必须完整执行 CLI 命令（例如：./visla_cli.sh avatar 或 ./visla_cli.sh voice）。
• 可在呈现给用户前对输出进行过滤：
  • 对 avatar 输出：移除所有含 Thumbnail: 的行
  • 对 voice 输出：移除所有含 URL: 的行
• 虚拟形象结果需按以下方式分类与格式化：
  • 按性别类别分组（Female、Male、Neutral、Dynamic）
  • 每个虚拟形象名称后标注 (n)，其中 n 表示该形象支持的外观数量
  • 对每种外观，显示：外观名称（lookUuid）
  • 格式为：- AvatarName (n): Look1 (uuid), Look2 (uuid), ...
  • 示例：

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

• 语音结果需按语言/区域分类（如：System、US English、Chinese、Japanese、French 等）
• 不得遗漏列表中的任何一项。用户必须看到全部可用的虚拟形象与语音，即使列表很长。
• 代理在配置视频时，必须使用列表中显示的确切 ID。

可选参数

visual 命令专用参数