用途:vhscli 是面向多模态 AI 的命令行客户端,既能理解(就文本、图片、视频、PDF 提问),也能生成图片、视频和音频。它只是瘦客户端,认证、上传与模型执行均在服务端进行,用户本地不存储任何服务商 API 密钥。
调用方式:始终通过 npx @getvhs/vhscli@latest <command> ... 运行,不要固定版本,也不要直接调用 PATH 上可能过期的 vhscli 二进制。需 Node.js ≥ 24。命令包括 login/logout、whoami、account、models、generate、submit、resume、poll、save 与 chat,可用 --help 查看当前帮助(CLI 为最终依据)。
主要能力:chat 支持文本、图片(-i,可重复)、PDF(-f,可重复)与单个视频(-v,--fps 0.2–5),为一次性调用,输出到 stdout;generate <model> <prompt> -o <path> 生成图片、视频或音频,-o 必填。可生成图片的模型有 seedream-5(默认)、seedream-5-pro、nano-banana-2、nano-banana-pro、gpt-image-2;视频为 seedance-2(最高 4k)、seedance-2.5(最高 720p);音频为 seed-audio-1,输出必须为 mp3。图片模型共用 --size,默认 1920x1080。
使用方式:generate 提交后等待并写入文件,会先打印 id;submit 只打印 task_id 后立即退出,-o 会被校验但不写入;resume <task_id> -o <path> 等待并写出;poll - 从 stdin 监听多个 id,打印第一个完成的;save <task_id> -o <path> 写出已完成任务。任务由后端记录,任务 id 是唯一句柄,本地无数据库或配置文件。任务 id 幂等,可重复提交同一 id 而不重复付费,也可用 --task-id 指定 id。
限制:chat 每次调用独立、无记忆,不保存到磁盘,且不识别视频中的音频;视频任务在云端运行,可能耗时数分钟;generate 中断可用 resume 继续,但丢失 task_id 会导致已付费任务无法找回;-o 不会自动改名或去冲突,覆盖前需自行确认路径。认证失败时运行 vhscli login,不要预先登录;login 需交互式浏览器。各提示词的模型专属指南可参考 prompt_guide/ 下对应文件。官方价格、收费与具体平台可用性资料未提供。