sjai CLI

闪剪开放平台官方命令行工具。

安装

npm install -g @sjai/open-cli

安装后：

sjai-open --help

API Key

使用此 CLI 工具需要 API Key。请访问：http://dev.shanjian.tv/ 获取您的 API Key。

认证

API Key 优先级顺序：

1. CLI 参数 --api-key
2. 环境变量 SJAI_API_KEY
3. 本地配置（通过 sjai-open auth login 保存）

命令：

sjai-open auth login --api-key <your-api-key>
sjai-open auth status
sjai-open auth logout

全局选项

• -i, --interactive 缺少必需参数时提示输入
• --debug 显示请求/响应调试信息
• --json 机器可读的输出（默认）
• --output-format <format> 输出格式：json, yaml, text, table
• --api-key <value> 内联 API Key
• --base-url <url> 覆盖 API 基础 URL
• --timeout <ms> 请求超时覆盖
• -o, --output <path> 下载输出文件路径
• --no-wait 立即返回，不等待轮询

命令列表

• task list|status|download
• virtualman list|clone|delete
• virtualman-fast clone
• virtualman-image clone
• video digital-human|digital-human-mix|real-human-mix|material-mix|news|custom-digital|custom-material|custom-real
• voice list|clone|delete
• audio tts|asr
• template list|info
• cover list|create
• public-virtualman list
• public-voice list
• config list|set|get
• auth login|logout|status

使用示例

# 配置 API Key（只需一次）
sjai-open auth login --api-key sk-xxxx

# 查看任务列表
sjai-open task list

# 查询任务状态
sjai-open task status task_123

# 下载任务结果（需要指定输出路径）
sjai-open task download task_123 --output ./out/result.mp4

# 交互式视频创作
sjai-open video digital-human -i

# 非阻塞视频创作
sjai-open video news --title "每日简报" --content "..." --template-id tpl_1 --no-wait

# 不同格式输出
sjai-open public-voice list --output-format table
sjai-open template list --scene virtualman --output-format yaml

输出和错误

• 人性化模式：简洁的文本，带有成功/错误/进度标记。
• JSON 模式：结构化数据，便于自动化处理。
• API/平台错误会包含 message 和 code。

开发

npm install
npm run typecheck
npm test
npm run build

发布

1. 更新 package.json 中的 version。
2. 运行 npm run test。
3. 运行 npm publish。