Hunyuan Video T2V

Playground

Hunyuan Video (t2v) is an advanced text-to-video model that generates high-quality videos from text prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Hunyuan Video Text-to-Video

Transform your ideas into stunning videos with Hunyuan Video Text-to-Video. This state-of-the-art model from Tencent generates high-quality 720p videos directly from text descriptions — bringing your imagination to life with smooth motion and cinematic visuals.

Why It Stands Out

Pure text-to-video generation: No source image required — simply describe your vision and watch it unfold.
HD output: Generate crisp 1280×720 videos with rich detail and visual clarity.
Prompt Enhancer: Built-in AI-powered prompt optimization helps craft better descriptions for improved results.
Smooth motion: Advanced temporal modeling ensures natural, fluid movement across frames.
Flexible sizing: Multiple aspect ratio options to fit your content needs.
Reproducibility: Use the seed parameter to recreate exact results or explore variations.

Pricing

Output	Price
Per video	$0.40

Parameters

Parameter	Required	Description
prompt	Yes	Text description of the video you want to generate.
size	No	Output resolution (default: 1280×720).
seed	No	Set for reproducibility; -1 for random.
num_inference_steps	No	Quality/speed trade-off (default: 30).

How to Use

Write a prompt describing the scene, characters, action, and style you want. Use the Prompt Enhancer for AI-assisted optimization.
Select size — choose the aspect ratio that fits your content.
Adjust inference steps — higher values may improve quality at the cost of speed.
Set a seed (optional) for reproducible results.
Click Run and wait for your video to generate.
Preview and download the result.

Best Use Cases

Social Media Content — Create viral-worthy video clips for TikTok, Reels, and Shorts.
Marketing & Advertising — Produce concept videos and promotional content without filming.
Storytelling & Animation — Generate scenes for short films, music videos, or creative projects.
Game & App Previews — Create cinematic trailers and gameplay concepts from descriptions.
Educational Content — Visualize complex concepts and scenarios for learning materials.

Pro Tips for Best Quality

Be detailed in your prompt — describe subject, action, environment, lighting, mood, and camera movement.
Include style keywords like “cinematic,” “realistic,” “anime,” or “futuristic” to guide the aesthetic.
Start with lower inference steps for quick previews, then increase for final renders.
Fix the seed when iterating to compare the effect of different prompt adjustments.
Keep prompts focused — overly complex descriptions may dilute the output quality.

Notes

Processing time varies based on current queue load.
Please ensure your prompts comply with content guidelines.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/hunyuan-video/t2v" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "size": "1280*720",
    "seed": -1,
    "num_inference_steps": 30
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
prompt	string	Yes		-	The positive prompt for the generation.
size	string	No	1280*720	1280720, 7201280	The size of the generated media in pixels (width*height).
seed	integer	No	-1	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.
num_inference_steps	integer	No	30	2 ~ 30	The number of inference steps to perform.

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Array of URLs to the generated content (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.has_nsfw_contents	array	Array of boolean values indicating NSFW detection for each output
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction, the ID of the prediction to get
data.model	string	Model ID used for the prediction
data.outputs	string	Array of URLs to the generated content (empty when status is not completed).
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Hunyuan Video I2V Hunyuan3d V2 Base