Hunyuan Video 1.5 Image To Video

Playground

HunyuanVideo-1.5 (i2v) is a lightweight 8.3B parameter image-to-video model that generates high-quality videos from images 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 Image-to-Video

HunyuanVideo-1.5 is Tencent’s lightweight, state-of-the-art video generation model. The image-to-video variant on WaveSpeedAI lets you animate a single still image into a smooth, cinematic clip guided by your text prompt, while keeping the original visual style and character identity stable.

Key features

High-quality image-to-video generation with strong motion coherence
Lightweight 8.3B-parameter design for fast inference
Multiple resolutions: 480p, 720p
Video durations: 5 s, 8 s, and 10 s

Limits and performance

Input: single image (any reasonable resolution; automatically resized/preprocessed)
Output: short video clip at selected resolution, duration, and aspect ratio
Recommended duration: up to 10 seconds per clip
Best performance with clear, well-lit images and a prompt that specifies motion, camera behavior, and mood

Pricing

Resolution	Price per second
480p	$0.02 / s
720p	$0.04 / s

How to use

Upload your input image (this becomes the starting frame of the video).
Enter a prompt describing the motion, camera movement, environment changes, and overall mood.
Choose the resolution: 480p, 720p.
Select the aspect ratio (16:9 for landscape or 9:16 for vertical/mobile).
Choose the duration: 5, 8, or 10 seconds.
Optionally set the seed for reproducibility.
Run the job and wait for processing.
Preview the generated video and download it from the WaveSpeedAI dashboard.

Tips for best results

Use a clean, high-resolution input image; avoid heavy compression and motion blur.
In the prompt, specify both what moves (hair, clothes, camera, background elements) and what stays stable (character pose, framing).
Mention camera behavior explicitly (e.g., “slow push-in,” “handheld shake,” “static camera with subtle parallax”).
Shorter durations (5–8 s) tend to produce the most coherent motion for complex scenes.
For a series of related clips, reuse the same seed and similar prompts to keep style and identity consistent.

Notes

HunyuanVideo-1.5 I2V is ideal for creators who want fast, controllable animation from still images without heavyweight hardware. It can be combined with high-end image models on WaveSpeedAI (such as Nano Banana Pro or Seedream v4) for a full pipeline: generate a keyframe with an image model, then bring it to life with HunyuanVideo.

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-1.5/image-to-video" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "resolution": "720p",
    "duration": 5,
    "seed": -1
}'

# 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
image	string	Yes		-	The image to generate the video from. Provide URL or base64 encoded image.
prompt	string	No		-	The positive prompt for the generation. Describes the motion and action in the video.
resolution	string	No	720p	480p, 720p	The resolution of the generated video.
duration	integer	No	5	5, 8	The duration of the generated video in seconds.
seed	integer	No	-1	-1 ~ 2147483647	The random seed to use for the generation. -1 means a random seed will be used.

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 Image 3 Hunyuan Video 1.5 Text To Video