HunyuanVideo 1.5 API

Introduction

HunyuanVideo 1.5 Image to video animates one photo into a 5 or 8 second clip at 480p or 720p. HunyuanVideo 1.5 is Tencent's open 8.3-billion-parameter video model.

Choose a mode by starting material

Key features

Faces that survive the motion

In our tests the people in the photo kept their faces, hair and wardrobe through the clip.

Any shape

There is no aspect-ratio field: portrait, square or widescreen photos come back in their own shape.

Prompt optional

Send only the photo and the model decides the motion, or describe the next moment yourself.

Request parameters

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.

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

Use cases

Living portraits

A headshot that smiles, sings or turns to the camera.

Product and fashion stills

Add fabric movement, a camera drift or a turn to a catalogue photo.

Prompt guide & pro tips

Describe the next moment

Write what the person does after the photo was taken, not what the photo shows.

Say what must stay

If a garment or prop must not change, say so in the prompt.

One person is easier than two

Two people in contact tend to tangle; keep their motion slow.

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/image-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/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "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

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Seedance 2.5 APIByteDance's newest: 30-second clips with native audioFrom 56 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Vidu Q4 Preview APIUp to 4K clips with sound and spoken dialogueFrom 34 credits for a 5-second clip
• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Kling O3 APIKling’s unified model: create, animate, reference and edit up to 4KFrom 51 credits for a 5-second clip

More about HunyuanVideo 1.5

Try it

HunyuanVideo 1.5 AI Video Generator onlineCreate videos with HunyuanVideo 1.5 in PopNow

Docs

HunyuanVideo 1.5 model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get HunyuanVideo 1.5 results without polling