从终端，开始创作。

把括狐的创作能力接进你的 Agent 和工作流。

CLI 将当前括狐账号的生成、任务、素材、画布和剪辑工作流接入本机终端与个人 Agent。模型、价格、权限及积分仍由括狐服务端核对。

安装

需要 Node.js 22 或更高版本。可使用官网提供的安装包：

npm install -g https://kuohu.work/cli/download/kuohu-work-cli-0.1.0.tgz
kuohu --help
kuohu install

kuohu install 安装随包附带的创作 Skills；用 --skills-dir 指定个人 Agent 读取的技能目录。它不读取其他 Agent 的账号或凭据，也不修改它们的模型设置。更新 CLI 时重新安装官网发布包；完整命令以 kuohu --help 为准。

开发者可从源码安装：

npm install -g ./packages/kuohu-cli

Access Key

1. 打开官网 /cli，登录括狐账号。
2. 新建并命名 Access Key。完整密钥只显示一次，立即复制保存。
3. 在终端的隐藏输入提示中粘贴密钥：

kuohu auth login
kuohu auth status
kuohu get-credit-balance

自动化环境可以设置 KUOHU_ACCESS_KEY，或通过 kuohu auth login --token-stdin < access-key.txt 从受保护的凭据文件读取。KUOHU_BASE_URL 可指定同一服务的完整 HTTPS 地址（含路径挂载）；本机测试仅允许回环 HTTP 地址。密钥不要放入命令参数、仓库、提示词或日志。

密钥有效期为 90 天，绑定创建时的账号及企业归属。账号禁用、密钥撤销或到期后，后续请求被拒绝。官网可以按名称查看最后使用时间并撤销密钥。kuohu auth logout 清除本机保存的密钥；如需终止其他机器的访问，应在官网撤销对应密钥。

模型与生成

kuohu models
kuohu generate-image --model MODEL --prompt "咖啡馆窗边的一束晨光"
kuohu generate-video --model MODEL --prompt "镜头缓慢推进，晨光照进咖啡馆" \
  --duration 5 --ratio 16:9 --resolution 720p

MODEL 使用 kuohu models 返回的实际模型或商品标识。可用性、比例、时长、分辨率和参考素材限制由当前服务端配置决定。

先用 --dry-run 获取报价；确认需求和预算后再提交生成。参考素材通过重复 --image、--video、--audio 参数传入，具体支持范围以所选模型为准。首尾帧使用 --first-last 并按首帧、尾帧顺序传两张图片。带本地参考图的图片编辑会先保存参考素材和专属画布，供服务端核对素材归属。

CLI 输出原任务标识、任务 API 地址和工作台入口；任务 API 地址供 CLI 认证调用，浏览器从工作台任务中心查看。请求超时或结果不明确时，先查原任务，不自动重建收费任务。任务成功与产物可下载分别判断：交付处理中继续查询。

查询与下载

kuohu tasks list
kuohu query-result --id TASK_ID --engine platform
kuohu query-result --id TASK_ID --engine platform --download-dir ./outputs

--engine 对应任务来源：platform、team 或 h3，请使用生成命令返回的来源。查询原 ID 不创建新任务。下载只携带当前服务的认证信息，不将 Access Key 转发到其他域名。现有文件不会被静默覆盖。

通用创作与短剧

kuohu agent create --provider xyq-creator --prompt "策划一个咖啡馆的故事"
kuohu agent create --provider xyq-drama-script --file drama-input.json --script script.txt

短剧按 xyq-drama-script、xyq-drama-images、xyq-drama-video、xyq-drama-compose 分阶段提交。后续阶段通过 JSON 输入引用原 sourceJobId、episodeId 等必要字段。各阶段仍需由当前模型目录确认通道可用、获取报价并提交；未开通的通道不会被本机 Skills 自动开通。参数与必填字段见 kuohu agent --help 和模型目录。

画布、导演台和剪辑

用 kuohu canvas --help、kuohu director --help 和 kuohu edit --help 查看子命令。画布的图结构与网页共用数据和版本号，更新时必须携带读取到的 revision，遇到冲突先重新读取，避免覆盖网页上的最新内容。

kuohu canvas create --title "咖啡馆的故事"
kuohu director shot-add --id CANVAS_ID --title "镜头 01" --prompt "晨光穿过玻璃窗" --duration 5
kuohu director get --id CANVAS_ID
kuohu edit create --title "咖啡馆剪辑"

导演台命令编辑与网页导演台共用的画布镜头、站位和机位数据；剪辑命令使用括狐现有多轨项目格式和 API，不安装或控制第三方本地剪辑软件。导出、渲染和本机交接能力以服务端当前返回值为准。

Agent Skills

随包提供 kuohu-creator、kuohu-canvas、kuohu-director，分别指导生成/查询/下载、图结构编辑和导演/剪辑工作流。技能仅描述 CLI 已实现能力；使用者现有任务授权仍然适用。

常见错误