vtrix models

vtrix models list

列出可用模型，支持按类型过滤和关键词搜索。

vtrix models list                          # 列出所有模型
vtrix models list --type video             # 按类型过滤：video / image / audio
vtrix models list --keywords kirin         # 按关键词搜索
vtrix models list --output id              # 仅输出 model ID（适合脚本）
vtrix models list --page 2 --page-size 20  # 分页

标志	说明
--type	按模型类型过滤：video / image / audio
--keywords	关键词搜索
--output	id 仅输出 model ID 列表 / json 完整 JSON
--page	页码，默认 1
--page-size	每页数量，默认 20

示例输出：

vtrix models list --type video --keywords spark

Models (2 results)

  spark_dance_v2_0       Seedance 2.0        video   text/image/video/audio
  spark_dance_v2_0_fast  Seedance 2.0 Fast   video   text/image/video/audio

Page 1 / 1  ·  Use --output json for full details

vtrix models list --type video --output id

spark_dance_v2_0
spark_dance_v2_0_fast
kirin_v2_6_t2v
kirin_v2_6_i2v
kirin_v3_t2v
...

---

vtrix models spec

从服务端实时拉取指定模型的参数规格，确保 Agent 和开发者始终获取最新、准确的参数定义。

vtrix models spec <model_id>               # 格式化文本输出（适合直接注入 Agent 上下文）
vtrix models spec <model_id> --output json # 原始 JSON（适合程序解析）

---

演示：Spark Dance 2.0

以 spark_dance_v2_0（Seedance 2.0 旗舰视频模型）为例，展示完整的查询和使用流程。

查看参数规格

vtrix models spec spark_dance_v2_0

Model: spark_dance_v2_0
Name:  Seedance 2.0
Type:  video

Parameters:
  content            array     required   多模态输入数组
                                          支持类型: text | image_url | video_url | audio_url

  resolution         string    optional   输出分辨率
                                          值: 480p | 720p | 1080p
                                          默认: 720p

  ratio              string    optional   画面比例
                                          值: 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive
                                          默认: adaptive

  duration           integer   optional   视频时长（秒），范围 4–15，-1 自动
                                          默认: 5

  generate_audio     boolean   optional   是否生成同步音频
                                          默认: true

  seed               integer   optional   随机种子，-1 随机
                                          默认: -1

  return_last_frame  boolean   optional   是否返回尾帧图像
                                          默认: false

  service_tier       string    optional   推理模式
                                          值: default | flex（flex = 离线推理，价格 -50%）
                                          默认: default

  camera_fixed       boolean   optional   固定摄像机视角
                                          默认: false

  callback_url       string    optional   任务完成回调地址

  safety_identifier  string    optional   终端用户标识符（≤ 64 字符）

获取 JSON 格式（供程序解析）

vtrix models spec spark_dance_v2_0 --output json

{
  "model_id": "spark_dance_v2_0",
  "name": "Seedance 2.0",
  "type": "video",
  "parameters": {
    "content": { "type": "array", "required": true },
    "resolution": { "type": "string", "required": false, "default": "720p", "enum": ["480p","720p","1080p"] },
    "ratio": { "type": "string", "required": false, "default": "adaptive" },
    "duration": { "type": "integer", "required": false, "default": 5, "min": 4, "max": 15 },
    "generate_audio": { "type": "boolean", "required": false, "default": true },
    "seed": { "type": "integer", "required": false, "default": -1 },
    "service_tier": { "type": "string", "required": false, "default": "default", "enum": ["default","flex"] }
  }
}

用该模型生成视频

查完规格后，直接用 vtrix run 提交任务：

# 文本生成视频，16:9，1080p，10 秒
vtrix run spark_dance_v2_0 \
  --param prompt="cinematic drone shot over misty mountain peaks at sunrise" \
  --param resolution=1080p \
  --param ratio=16:9 \
  --param duration=10 \
  --output url

Submitting task...
✓ Task created: task_abc123

Waiting for result...
████████████████████░░░░  82%  ~18s remaining

✓ Done
  https://cdn.vtrix.ai/outputs/task_abc123/output.mp4