⌘K

Vtrix CLI

Vtrix AI 平台的官方命令行工具,为 AI 智能体、自动化管线与开发者设计。

概述

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 接入文本、图像、视频、音频多模态能力,覆盖主流厂商模型。

提供商代表模型能力
VtrixKirin / Spark 系列视频 / 图像 / 音频
ViduQ1 / Q2 / Q3 系列视频
GoogleVeo 3.1 / Nano Banana视频 / 图像
OpenAIGPT Image 1 / 1.5图像
PixverseV6 系列视频
MiniMax / MurekaHailuo / Song Generator音频

即将推出

更多基础设施,敬请期待

以下功能正在积极开发中,将陆续向所有用户开放:

  • 积分管理:通过 CLI 查询账户积分余额、消耗明细,支持自动预警。
  • 更多基础设施:账单查询、用量统计、团队协作等能力持续推进中。