vtrix task

Usage

vtrix task status performs a single query for the given task_id — it does not poll automatically.

vtrix task status <task_id>                  # Human-readable format
vtrix task status <task_id> --output url     # Output result URL only
vtrix task status <task_id> --output json    # Full JSON

Task Status

status value	Meaning
pending	Queued
processing	Generating
completed	Done — result at output[0].content[0].url
failed	Failed — error details in the error field

---

Example: Async Task Management

Useful when you need to submit multiple tasks simultaneously and collect results later.

Submit a task and get the task_id immediately:

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

Single status query:

vtrix task status task_abc001

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

Query the result URL once the task completes:

vtrix task status task_abc001 --output url

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

Full JSON response:

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"
        }
      ]
    }
  ]
}

Poll until completion in a script:

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