Get API key

HunyuanVideo 1.5 API

by Tencent

Tencent's open video model for short 5–8 second clips

tencent/hunyuan-video-1.5/text-to-videoFrom 18 creditsfor a 5-second clip · $0.18
  • Up to 720p
  • 5–8s clips
  • Create Video
  • Image to Video
See examples

About HunyuanVideo 1.5

HunyuanVideo 1.5 is Tencent's open 8.3-billion-parameter video model. It turns a prompt or a single photo into a 5 or 8 second clip at 480p or 720p, in landscape or portrait, with a negative prompt on text-to-video.

Call it with the model name tencent/hunyuan-video-1.5/text-to-video on POST /jobs/createTask, from 18 credits for a 5-second clip ($0.18). New accounts get 30 free credits to try it in the Playground first.

Introduction

HunyuanVideo 1.5 Text to video turns a written prompt into a short clip. HunyuanVideo 1.5 is Tencent's open 8.3-billion-parameter video model; this endpoint returns 5 or 8 seconds at 480p or 720p in landscape or portrait, with a negative prompt for artefacts.

Choose a mode by starting material

What you haveMode
a written descriptionHunyuanVideo 1.5 Text to video
a photo to animateHunyuanVideo 1.5 Image to video

Key features

Natural people at a small size

The model has 8.3 billion parameters, yet in our tests faces, skin, hair and fabric looked photographic and moved without melting.

Four frame sizes

aspect_ratio and resolution combine into 832 x 480, 480 x 832, 1280 x 720 or 720 x 1280, so vertical clips are composed for the screen, not cropped.

Negative prompt

List what you never want to see. It is the quickest fix for stray text, warped hands or blur.

Request parameters

ParameterRequiredDescription
seedNoReuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647
promptYesDescribe the scene, the action and the camera.
resolutionNoOutput size. Bigger sizes look sharper and cost more. 480p · 720p · Default: 720p
aspect_ratioNoThe shape of the frame: wide, square or tall. 16:9 · 9:16 · Default: 16:9
negative_promptNoThings you don't want to see.
duration_secondsNoHow long the clip runs. You pay per second. 5 · 8 · Default: 5

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

OptionCredits per second≈ USD
resolution 480p3.6$0.036
resolution 720p7.2$0.072

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Vertical social clips

9:16 at 720 x 1280 for feeds and stories.

Prompt guide & pro tips

Write the shot

Subject, wardrobe, action, light, camera: in that order, in two to four sentences.

One action per clip

Five seconds is one gesture or one move. Chains of actions blur together.

Keep contact scenes simple

Two people touching tend to tangle limbs; slow movement and a wider shot help.

Draft small

Run the idea at 480p with a fixed seed, then rerun the winner at 720p.

API quick start

Call the HunyuanVideo 1.5 API in three steps

  1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
  2. Send the request. POST /jobs/createTask with model tencent/hunyuan-video-1.5/text-to-video and an input object that follows the parameter table. The response returns a task ID straight away.
  3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "tencent/hunyuan-video-1.5/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

HunyuanVideo 1.5 API questions

How much does the HunyuanVideo 1.5 API cost?

HunyuanVideo 1.5 starts at 18 credits ($0.18) for a 5-second clip with Create Video, its cheapest task. Prices by option: 480p 3.6 credits per second, 720p 7.2 credits per second. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.

What is the model name for HunyuanVideo 1.5 in the API?

Put tencent/hunyuan-video-1.5/text-to-video for Create Video; tencent/hunyuan-video-1.5/image-to-video for Image to Video in the model field of POST /jobs/createTask.

What is HunyuanVideo 1.5?

An open video model from Tencent's Hunyuan team, released in November 2025. Tencent describes it as an 8.3-billion-parameter diffusion transformer with a 3D causal VAE and an attention scheme that skips redundant parts of the video, built to run on consumer GPUs.

How long and how large are the clips?

5 or 8 seconds at 24 frames per second, at 480p or 720p. Text-to-video gives 832 x 480, 480 x 832, 1280 x 720 or 720 x 1280; image-to-video keeps the shape of your photo.

Does it generate sound?

No. The clips are silent MP4 files with no audio track. Add sound in your own edit, or pick a model that generates audio with the picture.

Do I need a prompt for image-to-video?

No. The prompt is optional there: without one the model animates the photo on its own. With one, describe the motion and the camera, not the photo itself.

How long does a clip take?

In our tests a 5-second 480p clip took about one to two and a half minutes of model time, and a 5-second 720p clip about two and a half to four minutes.

What are the limits of the HunyuanVideo 1.5 API?

Clip length: 5–8 s; Resolutions: 480p · 720p; Aspect ratios: 16:9 · 9:16. Requests outside these limits are rejected before anything is charged.

Can I try HunyuanVideo 1.5 without writing code?

Yes. The Playground runs HunyuanVideo 1.5 on your PopNow credits, needs no API key, and shows the matching code for every run.

More about HunyuanVideo 1.5