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. The platform adds no content filter to the prompt or the clip.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| a written description | HunyuanVideo 1.5 Text to video |
| a photo to animate | HunyuanVideo 1.5 Image to video |
Key features & highlights
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.
Uncensored
No filter on the prompt or the result. In our tests most content probes rendered as written; the strongest held part of the scene back.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Describe who is in frame, what they wear and do, and what the camera does. One clear action per clip works best. at least 1 characters |
negative_prompt | No | Optional list of things to keep out, such as "blurry, distorted hands, extra limbs, text, watermark". It does not change the price. |
aspect_ratio | No | 16:9 for landscape (the default) or 9:16 for portrait. The shape does not change the price. |
resolution | No | 480p (832 x 480) or 720p (1280 x 720, the default). 720p costs twice as much per second; draft at 480p. |
duration_seconds | No | 5 or 8 seconds, billed per second. |
seed | No | Keeps runs comparable while you change one thing at a time. It does not promise a frame-identical clip. |
Pricing
Billed per second of output at the chosen resolution. The aspect ratio does not change the price.
| Specification | Price |
|---|---|
| $0.024 / second |
| $0.048 / second |
Use cases
Vertical social clips
9:16 at 720 x 1280 for feeds and stories.
Prompt exploration
At 480p a five-second draft is cheap, so you can try many prompts before you upscale the idea.
Unfiltered clips for your platform
No content filter on the prompt or the clip, with adults only on screen.
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
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_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",
"resolution": "720p",
"aspect_ratio": "16:9",
"duration_seconds": 5
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.








