Skip to content

TokenHub Now Supports the Full Vega Video Model Lineup โ€‹

Updated

The TokenHub API now supports every Vega Video model. All six model values share the same submit and poll endpoints (POST /v1/wand/vega-videos/tasks, GET /v1/wand/vega-videos/tasks/{id}), so switching versions is just a matter of changing model.

The integration docs have also been split by version. Open the Vega Video overview and click a card to see that version's input specs, request parameters, and request examples.

Versionmodel valueResolutionDuration (s)Allowlist
1.5 Prowand-vega-video-1.5-pro480Pโ€“4K4โ€“30, or -1Required
1.5 Litewand-vega-video-1.5-lite480Pโ€“4K2โ€“30Not required
1.0 Prowand-vega-video-1.0-pro480Pโ€“4K4โ€“15, or -1Required
1.0 Pro Fastwand-vega-video-1.0-pro-fast480Pโ€“4K4โ€“15, or -1Required
1.0 Pro Miniwand-vega-video-1.0-pro-mini480Pโ€“4K4โ€“15, or -1Required
1.0 Litewand-vega-video-1.0-lite480P / 768P / 1080P / 2K / 4K4โ€“15Not required

1. How to Pick a Version โ€‹

  • 1.5 Pro โ€” Highest specs. Up to 30 seconds, with support for duration=-1 (model decides the length) and asset:// asset references.
  • 1.5 Lite โ€” Latest Lite. Durations go as low as 2 seconds and no allowlist is needed.
  • 1.0 Pro / Pro Fast / Pro Mini โ€” Standard, fast, and Mini variants; all support asset:// and duration=-1.
  • 1.0 Lite โ€” Cost-efficient tier. Defaults to 768P and has no 720P step.

asset:// asset references and duration=-1 are Pro-only. Passing them to either Lite version returns an error.

2. Integration Paths โ€‹

Whether your reference assets contain a real human face determines how long the call chain is.

ScenarioCall chain
โ‘  General generationCreate generation task โ†’ poll task result
โ‘ก Non-real-person assetsCreate asset โ†’ query asset โ†’ create task โ†’ poll result
โ‘ข Real-person assetsStart liveness check โ†’ poll check result โ†’ create real-person asset โ†’ query asset โ†’ create task โ†’ poll result

3. Before You Start โ€‹

  • The four Pro models require allowlist access โ€” contact the WAND team to register.

  • A resolution outside the current version's steps is rejected at submit time with 400 invalid_request_error; it is never downgraded to a nearby step.

  • The submit endpoint is not idempotent. Re-sending the same request issues a new task ID and may double-charge you.

  • content.video_url in the result is valid for 12 hours โ€” download and move it to your own storage as soon as the task succeeds.

  • Vega Video overview โ€” the per-version API docs plus Asset Library and Liveness Verification all start from this page.

Built with VitePress ยท Deployed on Tencent EdgeOne Pages