概述
Vtrix CLI 是 Vtrix AI 平台的官方命令行工具,覆盖平台的核心能力:
- 模型调用:直接在终端提交多模态生成任务(视频 / 图像 / 音频),实时等待结果。
- Skill 管理:从 SkillHub 搜索、安装 Agent Skill,让 Claude Code、Cursor 等 Agent 直接调用 Vtrix 模型能力。
认证是模型调用和 Skill 管理的前置步骤,通过 vtrix auth login 完成浏览器授权,或使用 vtrix auth set-key 直接写入 API Key,凭据自动存储,后续调用无需额外操作。
核心能力
- 模型发现:通过
vtrix models list按类型浏览模型、关键词搜索,快速找到所需模型。 - 实时参数规格:通过
vtrix models spec从服务端实时拉取模型参数规格,Agent 和开发者始终可以获取最新、准确的参数定义,避免因文档滞后导致调用错误。 - 模型调用:通过
vtrix run提交生成任务,支持文本、图像、视频、音频等多模态输入,内置进度追踪,任务完成后直接输出结果。 - Skill 管理:通过
vtrix skills搜索和安装 Agent Skill,自动检测并安装到 Claude Code、Cursor、Codex 等 Agent 环境。 - Agent 友好:
--output json结构化输出、--dry-run演练模式、POSIX 退出码,适合 Agent 自动调用。
安装
# 需要 Node.js >= 18
npm install -g @vtrixai/vtrix-cli
# 验证安装
vtrix version # 需要 Go >= 1.26
git clone https://github.com/VtrixAI/vtrix-cli.git
cd vtrix-cli && make install
# 用户本地安装(无需 sudo)
make install PREFIX=$HOME/.local
export PATH="$HOME/.local/bin:$PATH" # 支持平台
macOS amd64 / arm64 (Apple Silicon)
Linux amd64 / arm64
Windows amd64
# 从 GitHub Releases 下载对应平台二进制
# https://github.com/VtrixAI/vtrix-cli/releases 平台概览
通过一个 API Key 接入文本、图像、视频、音频多模态能力,覆盖主流厂商模型。
| 提供商 | 代表模型 | 能力 |
|---|---|---|
| Vtrix | Kirin / Spark 系列 | 视频 / 图像 / 音频 |
| Vidu | Q1 / Q2 / Q3 系列 | 视频 |
| Veo 3.1 / Nano Banana | 视频 / 图像 | |
| OpenAI | GPT Image 1 / 1.5 | 图像 |
| Pixverse | V6 系列 | 视频 |
| MiniMax / Mureka | Hailuo / Song Generator | 音频 |
即将推出
更多基础设施,敬请期待
以下功能正在积极开发中,将陆续向所有用户开放:
- 积分管理:通过 CLI 查询账户积分余额、消耗明细,支持自动预警。
- 更多基础设施:账单查询、用量统计、团队协作等能力持续推进中。