使用 Visla 将文字脚本、链接或 PPT/PDF 文档生成 AI 视频。适用于用户要求生成视频或将网页转为视频的场景。
Visla Video Crowth.
功能概述
Visla Video Crowth.是一项面向实际任务的技能，主要用于Version: 260501-1423. 创建来自文本脚本,网络URL,或文档(PPT/PDF)的AI生成的视频,使用Visla的OpenAPI...；Before You Start.；
核心要点
- Creditises(NEVER输出API k)。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
使用与执行
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Visla 视频生成
版本：260501-1423
使用 Visla 的 OpenAPI，基于文本脚本、网页 URL 或文档（PPT/PDF）生成 AI 视频。
开始前准备
凭证（切勿在响应中输出 API 密钥/密钥）：
重要提示：切勿在响应中输出 API 密钥或密钥。
- 检查
~/.config/visla/.credentials文件是否存在（此时请勿读取其内容）。 - 若该文件存在，请使用基于选项的确认方式向用户提问：
“已找到已保存的凭证。是否允许读取
~/.config/visla/.credentials？” 可选操作：允许 / 否 - 若用户选择允许，则继续执行命令。
- 若用户选择否，或该文件不存在：
请提示用户提供凭证，方式如下之一：
- 环境变量（
VISLA_API_KEY、VISLA_API_SECRET） - CLI 参数（
--key、--secret） - 直接输入 API 密钥和密钥
- 环境变量（
- 若提供的凭证返回错误
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。
- Python CLI 在检测到
注意：切勿打印凭证。优先使用环境变量或经显式用户授权后自动检测的凭证。
命令列表
| 命令 | 说明 |
|---|---|
/visla script |
基于脚本（文本或本地文件）生成视频 |
/visla url |
基于网页 URL 生成视频 |
/visla doc |
基于文档（PPT/PDF）生成视频 |
/visla idea |
基于创意描述生成视频 |
/visla visual |
基于视觉资源（图像/视频）生成视频，支持多个文件 |
/visla speech |
基于语音（音频/视频文件）生成视频，支持多个文件 |
/visla account |
显示账户信息及信用余额 |
/visla avatar |
列出可用的 AI 虚拟形象 |
/visla voice |
列出可用的 AI 语音 |
重要提示：针对 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。
可选参数
| 参数 | 说明 |
|---|---|
-c, --config |
JSON 配置文件路径，用于指定视频参数 |
--avatar |
用于视频的虚拟形象 ID（通过 avatar 命令获取） |
--voice |
用于视频的语音 ID（通过 voice 命令获取） |
visual 命令专用参数
| 参数 | 说明 |
|---|---|
--script, -s |
脚本或描述文本（或 @filename） |
--style |