Vtrix CLI 快速开始 | Vtrix API Docs

上手步骤

安装 CLI

npm install -g @vtrixai/vtrix-cli

登录认证

执行登录命令，CLI 会打印设备码和授权 URL，并自动尝试打开浏览器。完成授权后，凭据存储在本地 keychain，后续自动复用。

vtrix auth login
vtrix auth status

运行第一个任务

# 文本转视频
vtrix run spark_dance_v2_0 \
  --param prompt="dancer in neon rain, cinematic slow motion" \
  --param duration=5 \
  --output url

# 图像转视频
vtrix run kirin_v2_6_i2v \
  --param image=https://example.com/photo.jpg \
  --param prompt="gentle breeze, leaves swaying" \
  --output url

完整工作流

# 1. 查看模型参数规格
vtrix models spec spark_dance_v2_0

# 2. 演练模式 —— 预览请求，不消耗积分（无需登录）
vtrix --dry-run run spark_dance_v2_0 --param prompt="neon city at night"

# 3. 提交任务并等待完成，--output json 输出完整响应
vtrix run spark_dance_v2_0 \
  --param prompt="neon city at night" \
  --output json

# 4. 查询已有任务的状态（单次查询）
vtrix task status <task_id> --output json

# 5. 仅获取结果 URL
vtrix task status <task_id> --output url