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.3.6
homepage	https://ai.tvi.v.qq.com/zenstudio
allowed-tools	Bash,Read
metadata	{"openclaw":{"emoji":"🎬","requires":{"bins":["zencli"],"env":["ZENSTUDIO_API_KEY","ZENSTUDIO_ENDPOINT","ZENCLI_CONFIG_DIR","ZENCLI_NO_UPDATE_CHECK"]},"primaryEnv":"ZENSTUDIO_API_KEY","credentials":{"storage":"~/.zencli/config.json","configDirEnv":"ZENCLI_CONFIG_DIR","description":"zencli auth login 写入的 API Key 持久化文件，JSON 格式，仅存储 api_key 和 endpoint。非持久化容器中可通过 ZENCLI_CONFIG_DIR 环境变量指定配置目录"},"install":[{"id":"npm","kind":"node","package":"zenstudio-cli@1.3.6","bins":["zencli"],"label":"Install ZenStudio CLI (npm)"}],"category":"AIGC","tags":["zenstudio","aigc","cli","video-generation","image-generation","ai-tools"]}}
license	MIT-0
author	ZenStudio Team
user-invocable	true

ZenStudio CLI (zencli)

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

安装 & 配置

npm install -g zenstudio-cli@1.3.6

# 配置 API Key（三选一）
zencli auth login                          # 交互式登录（推荐）
zencli auth login --token <YOUR_API_KEY>   # 命令行传入
export ZENSTUDIO_API_KEY=<YOUR_API_KEY>    # 环境变量（仅推荐 CI/CD，Agent/子进程可能读不到 shell 配置）
# ↑ auth login 自动将 Token 写入配置文件：
#   若 ZENCLI_CONFIG_DIR 已设置 → $ZENCLI_CONFIG_DIR/config.json
#   否则 → ~/.zencli/config.json

zencli auth status                         # 验证登录状态

API Key 申请：Claw 配置

命令速查

# === 项目管理 ===
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 --prompt "描述" --model <provider_id> --poll                        # 纯文生视频（默认 Text 模式）
zencli generate video --prompt "描述" --model <provider_id> --single-image-url "url" --poll  # 图生视频（Text 模式 + 参考图）
zencli generate video --mode FirstLastFrame --prompt  --model <provider_id> --first-frame-url  --poll  




zencli asset create --url <cdn_url> --project-id <> -o json  
zencli asset search --project-id <>      
zencli asset get <asset_id>                
zencli asset update <asset_id> --name   


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]