Visla 视频生成

版本：260218-1410

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

开始之前

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

重要：仅在获得用户明确同意后读取本地凭证文件。

1. 在读取之前，请先询问用户是否许可~/.config/visla/.credentials
2. 如果获得许可且该文件存在有效的凭证，请在使用--credentials-file ~/.config/visla/.credentials时配合PythonCLI。而BashCLI 不支持--credentials-file参数，因此请改用环境变量。
3. 如果用户拒绝许可、文件缺失或凭证无效，请向用户询问凭证信息

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

• 告知用户：这是一次性设置（一旦配置完成，后续无需重复此操作）
• 告知用户：从以下网址获取API密钥和密钥https://www.visla.us/visla-api
• 明确要求提供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)

平台执行

默认策略：

• 优先选择Bash在macOS上，当依赖项可用时（Bash CLI可避免某些macOS设置中的Python SSL堆栈问题）。
• 优先选择Python当您已在使用配置良好的Python环境时（或当Bash依赖项缺失时）。

Bash（在macOS上推荐；也适用于类Linux环境）：

# 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（跨平台）：

python3 scripts/visla_cli.py --key "your_key" --secret "your_secret" <command>
# Or, with user consent:
python3 scripts/visla_cli.py --credentials-file ~/.config/visla/.credentials <command>

Windows原生（PowerShell/CMD，无Bash；使用Python）：

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

Windows注意事项：

• 代理应优先运行Python CLI在Windows上，除非已验证Bash环境（WSL/Git Bash）可用。
• 对于简单脚本，直接传递：python scripts/visla_cli.py script "场景1：..."
• 对于多行或复杂脚本，请使用标准输入配合-（推荐，无需临时文件）：

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

• 如果您已安装 Python Launcher，py -3 scripts/visla_cli.py <命令>可能比python效果更好。
• 凭证：
  • Python CLI 仅在明确提供了--credentials-file参数时才会读取凭证文件。
  • 在 Windows 上，默认路径通常为：%USERPROFILE%\\.config\\visla\\.credentials。

注意：请勿打印凭证。建议使用环境变量或--credentials-file并需获得用户明确同意。

命令

获取确切CLI界面的权威来源：运行scripts/visla_cli.sh --help或python3 scripts/visla_cli.py --help。

脚本格式

**Scene 1** (0-10 sec):
**Visual:** A futuristic calendar flipping to 2025 with digital patterns.
**Narrator:** "AI is evolving rapidly! Here are 3 game-changing AI trends."

**Scene 2** (10-25 sec):
**Visual:** Text: "Trend #1: Generative AI Everywhere." Show tools like ChatGPT.
**Narrator:** "Generative AI is dominating industries—creating content and images."

工作流程

`script`、`url`和`doc`命令会自动执行完整流程：创建项目

1. Create project
2. 轮询直至生成完成（可能需要几分钟）
3. 自动导出并返回下载链接

执行说明：

• 告知用户视频生成需要一定时间
• 轮询期间定期报告进度状态

超时指导

• 此工作流通常需要3-10分钟，但在最坏情况下可能长达约30分钟。请将任务/命令的超时时间设置为≥30分钟（Windows默认值通常约为10分钟，需要增加）。如果无法更改超时设置，请提前告知用户，并在超时发生时询问是继续执行还是切换为分步运行。
• 若发生超时，CLI会在输出中返回项目UUID。请告知用户可通过Visla网页界面或API手动检查项目状态并在稍后继续处理。

示例

/visla script @myscript.txt
/visla script "Scene 1: ..."
/visla url https://blog.example.com/article
/visla doc presentation.pptx
/visla account

支持的文档格式

• PowerPoint：.pptx、.ppt
• PDF：.pdf

输出格式

• 开始：技能开始时显示“Visla Skill v260218-1410”
• 结束：技能完成时显示“Visla Skill v260218-1410 已完成”