HunyuanVideo Foley API

hunyuan-video-foley
Designed for scalability, it streamlines audio production across film, gaming, and social media content.
Output
$0.013 / sec

How to use HunyuanVideo Foley API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to hunyuan-video-foley.
import requests, time

headers = {"Authorization": "Bearer " + AIMLAPI_KEY}
job = requests.post(
    "https://api.aimlapi.com/v2/video/generations",
    headers=headers,
    json={
      "model": "hunyuan-video-foley",
      "prompt": "A serene timelapse of clouds over a mountain range"
    },
).json()
gid = job["id"]

while True:
    res = requests.get(f"https://api.aimlapi.com/v2/video/generations?generation_id={gid}", headers=headers).json()
    if res.get("status") in ("completed", "error"):
        break
    time.sleep(5)
print(res["video"]["url"])
const headers = {
  Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
  "Content-Type": "application/json",
};
const job = await (await fetch("https://api.aimlapi.com/v2/video/generations", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "model": "hunyuan-video-foley",
    "prompt": "A serene timelapse of clouds over a mountain range"
  }),
})).json();

let res;
do {
  await new Promise((r) => setTimeout(r, 5000));
  res = await (await fetch(`https://api.aimlapi.com/v2/video/generations?generation_id=${job.id}`, { headers })).json();
} while (!["completed", "error"].includes(res.status));
console.log(res.video.url);
# submit the generation — the response contains the job "id"
curl -X POST https://api.aimlapi.com/v2/video/generations \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"hunyuan-video-foley","prompt":"A serene timelapse of clouds over a mountain range"}'

# then poll until status is "completed" — video.url holds the result
curl "https://api.aimlapi.com/v2/video/generations?generation_id={id}" -H "Authorization: Bearer $AIMLAPI_KEY"

OpenAI-compatible — swap the base URL and it works with your existing SDK.

HunyuanVideo Foley API Pricing

TypePrice
Output
$0.013 / sec

HunyuanVideo Foley vs other models

ModelInputOutputContextBest for
$0.013 / sec
Video generation
$0.26 / sec (variable)
Video generation
$0.13 / sec (variable)
Video generation
$1.95 / 1M tokens
$22.75 / 1M tokens
Video generation
$0.09243–$1.014 / sec (by resolution)
Cinematic video + native audio

Frequently asked questions

HunyuanVideo Foley takes image, text, video as input and returns video.

HunyuanVideo Foley is priced at $0.013 / sec.

HunyuanVideo Foley is billed per generation — a fixed charge per output rather than by prompt length.

Yes, HunyuanVideo Foley accepts image input as well as a text prompt.

HunyuanVideo Foley was built by Tencent.

Use hunyuan-video-foley as the model id on AI/ML API.

Yes. HunyuanVideo Foley is served through AI/ML API, so the same key and endpoint format used for other models applies.

No. It generates synchronized foley audio for existing video rather than producing new video content.

It generates realistic sound effects synchronized with the video's content.

Start building with HunyuanVideo Foley

Get API Key
1000+ models, one API.