vtrix task

用法

vtrix task status 对指定 task_id 执行单次查询，不自动轮询。

vtrix task status <task_id>                  # 人类可读格式
vtrix task status <task_id> --output url     # 仅输出结果 URL
vtrix task status <task_id> --output json    # 完整 JSON

任务状态

status 值	含义
pending	排队中
processing	生成中
completed	完成，结果在 output[0].content[0].url
failed	失败，错误信息在 error 字段

---

示例：异步任务管理

适合需要同时提交多个任务、稍后统一收取结果的场景。

提交任务后立即拿到 task_id：

vtrix run spark_dance_v2_0 \
  --param prompt="aerial shot of ocean waves at golden hour" \
  --param duration=8 \
  --output json | jq -r '.task_id'

task_abc001

单次查询当前状态：

vtrix task status task_abc001

Task:    task_abc001
Status:  processing
Model:   spark_dance_v2_0
Created: 2026-04-10 14:32:05
Elapsed: 23s

任务完成后查询结果 URL：

vtrix task status task_abc001 --output url

https://cdn.vtrix.ai/outputs/task_abc001/output.mp4

完整 JSON 响应：

vtrix task status task_abc001 --output json

{
  "task_id": "task_abc001",
  "status": "completed",
  "model": "spark_dance_v2_0",
  "created_at": "2026-04-10T14:32:05Z",
  "completed_at": "2026-04-10T14:32:51Z",
  "output": [
    {
      "content": [
        {
          "type": "video_url",
          "url": "https://cdn.vtrix.ai/outputs/task_abc001/output.mp4"
        }
      ]
    }
  ]
}

在脚本中轮询直到完成：

TASK_ID="task_abc001"

while true; do
  STATUS=$(vtrix task status "$TASK_ID" --output json | jq -r '.status')
  echo "Status: $STATUS"

  if [ "$STATUS" = "completed" ]; then
    vtrix task status "$TASK_ID" --output url
    break
  elif [ "$STATUS" = "failed" ]; then
    echo "Task failed" >&2
    exit 1
  fi

  sleep 5
done

Status: processing
Status: processing
Status: completed
https://cdn.vtrix.ai/outputs/task_abc001/output.mp4