zenstudio

name	zenstudio
description	ZenStudio 官方 AI 内容创作 CLI 工具 (zencli)。支持 AI 生图、AI 生视频、项目管理、资产库、媒资管理、无限画布、文件上传下载等。Use when user asks to generate images, generate videos, manage projects, upload files, download assets, manage materials, or interact with ZenStudio platform via command line.
description_zh	ZenStudio AI 内容创作（生图、生视频、画布、素材管理）
description_en	ZenStudio AI content creation: image/video generation, canvas, assets
version	1.2.6
homepage	https://ai.tvi.v.qq.com/zenstudio
allowed-tools	Bash,Read
metadata	{"clawdbot":{"emoji":"🎬","requires":{"bins":"[Truncated]","env":"[Truncated]"},"install":["[Truncated]"]}}

ZenStudio CLI (zencli)

AI 内容创作全流程命令行工具，封装 ZenStudio 平台 19+ 核心能力。

安装 & 配置

npm install -g zenstudio-cli

# 配置 API Key（三选一）
zencli auth login                          # 交互式登录（推荐，存入 ~/.zencli/config.json，所有环境可用）
zencli auth login --token <YOUR_API_KEY>   # 命令行传入（同上）
export ZENSTUDIO_API_KEY=<YOUR_API_KEY>    # 环境变量（仅推荐 CI/CD，Agent/子进程可能读不到 shell 配置）

zencli auth status                         # 验证登录状态

API Key 申请：API 管理

命令速查

# === 项目管理 ===
zencli project list [--search "关键词"]    # 列出/搜索项目
zencli project create "项目名"             # 创建项目
zencli project get <id>                    # 项目详情
zencli project update <id> --name "新名称" # 更新项目

# === 上传 / 下载 ===
zencli upload ./file.png -o json           # 上传文件 (COS SDK 直传)
zencli download <asset_id> [-d ./output/]  # 下载素材 (自动处理私有读签名)

# === AI 生图 ===
zencli generate image-models               # 查看可用模型（必须先调用！）
zencli generate image --prompt "描述" --model <model_id> [--aspect-ratio 16:9] [--input-images "url"] --poll

# === AI 生视频 (4 种驱动模式) ===
zencli generate video-models               # 查看可用模型（必须先调用！）
zencli generate video --mode Text --prompt "描述" --model <provider_id> --single-image-url "url" --poll
# 其他模式: FirstLastFrame(--first/last-frame-url)  FrameSequence(--sequence-frames)  SubjectToVideo(--reference-assets)
# 通用选项: --duration <秒> --count 1-4 --enable-sound --poll

# === 媒资库 (asset) — 项目级媒体文件池 ===
zencli asset create --url <cdn_url> --project-id <id> -o json  # 入库（返回带签名 URL）
zencli asset search --project-id <>      
zencli asset get <asset_id>                


zencli material list role_person           
zencli material add ...                    
zencli material get <material_id>          
zencli role get <role_id>                  


zencli canvas list                         
zencli canvas create                 
zencli canvas build-draft <canvas_id> --file nodes.json          
zencli canvas build-draft <canvas_id> --nodes             
zencli canvas build-draft <canvas_id> -d                
zencli canvas build-draft <canvas_id> -n  -d        
zencli canvas build-draft <canvas_id> -n  --mode overwrite  


zencli generate task <task_id> [--poll]    


zencli tools list                          
zencli tools describe <tool_name>          
zencli tools call <tool_name> --arg key=value [--json-args ]


zencli url build  [--params ]  
zencli url parse <url>                     
zencli upgrade [--check]