API docs / Video models

Hunyuan Video API

Generates videos from text descriptions with realistic motion and temporal consistency. Supports various aspect ratios and resolutions up to 1280x1280 pixels, with configurable video lengths from 1 to 200 frames at customizable frame rates. Uses a spatial-temporally compressed latent space approach with large language model text encoding for advanced prompt handling. Features a built-in prompt rewrite system and stable motion generation capabilities. The model is optimized with parallelized GPU processing using context parallel attention for efficient inference.

Model id
tencent/hunyuan-video
Provider
tencent
Output
Video
Price
From 439 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "tencent/hunyuan-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "tencent/hunyuan-video",
  "input": {
    "prompt": "A cat walks on the grass, realistic style"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptstring

The prompt to guide the video generation

Default: A cat walks on the grass, realistic style

duration_secondsnumber

Number of frames to generate (must be 4k+1, ex: 49 or 129)

Default: 129

Min 1 · Max 200

fpsnumber

Frames per second of the output video

Default: 24

Min 1

seednumber

Random seed (leave empty for random)

guidancenumber

Guidance scale

Default: 6

Min 1 · Max 10

stepsnumber

Number of denoising steps

Default: 50

Min 1

heightnumber

Height of the video in pixels (must be divisible by 16)

Default: 480

Min 16 · Max 1280

widthnumber

Width of the video in pixels (must be divisible by 16)

Default: 864

Min 16 · Max 1280