Hunyuan Video 1.5 Text To Video API Documentation

Hunyuan Video 1.5 Text To Video API Documentation

Playground

HunyuanVideo-1.5 (t2v) is a lightweight 8.3B parameter text-to-video model that generates high-quality videos with top-tier visual quality and motion coherence. Optimized for fast inference on consumer-grade GPUs. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

HunyuanVideo-1.5 is Tencent’s lightweight text-to-video generation model that delivers state-of-the-art visual quality and motion coherence with only 8.3B parameters. It is designed to be both powerful and efficient, making high-quality video generation accessible for everyday creators and production workflows on WaveSpeedAI.

Key Features

• High-quality video generation directly from text prompts
• Lightweight 8.3B parameters for fast inference on consumer-grade GPUs
• Video durations: 5 s, 8 s, and 10 s
• Strong motion coherence and stable subject identity

Pricing

How to Use

1. Write your text prompt describing the scene, characters, motion, camera movement, and overall style.
2. Select the duration: 5 s, 8 s, or 10 s.
3. Optionally tweak inference steps or seed to balance speed, quality, and reproducibility.
4. Run the job from the WaveSpeedAI interface.
5. Preview the generated clip and download it from the dashboard.

Tips for Best Results

• Be explicit: describe who is in the scene, what they are doing, where they are, and how the camera moves.
• Mention style and mood (for example, “cinematic lighting,” “handheld documentary,” “anime style,” “neon cyberpunk city”).
• Shorter clips (5–8 s) generally produce the most coherent and visually stable results.
• Reuse similar prompts and seeds when you want a series of related shots that share style and characters.

Upscaling for Higher Quality

After generating your base video with HunyuanVideo-1.5, you can use WaveSpeedAI’s dedicated video super-resolution models to enhance clarity and sharpness:

• WaveSpeedAI Video Upscaler
• WaveSpeedAI Video Upscaler Pro

Generate efficiently at 480p or 720p, then upscale to higher resolutions for a better final viewing experience.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "prompt": "A cinematic ocean wave at sunrise, highly detailed",
  "size": "1280*720",
  "duration": 5,
  "seed": -1
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-video-1.5/text-to-video" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Response Parameters

Result Request Parameters

Result Response Parameters