models/Tencent/Hunyuan Video Foley
Tencent

Hunyuan Video Foley

video
Compare

Use the capabilities of the hunyuan foley model to bring life to your videos by adding sound effect to them.

MODALITIES
video
PER SECOND
$0.100

Hunyuan Video Foley (tencent/hunyuan-video-foley) is a video model from Tencent. Pricing via AIgateway: $0.100 per second. Call it via https://api.aigateway.sh/v1/videos/generations — set model="tencent/hunyuan-video-foley". Best for: Ads, Storyboards, Demos.

model · tencent/hunyuan-video-foley

Use this model

model: tencent/hunyuan-video-foley
curl https://api.aigateway.sh/v1/videos/generations \
  -H "Authorization: Bearer $AIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tencent/hunyuan-video-foley","prompt":"a slow drone shot over a mountain lake"}'

Capabilities

Strengths

  • Text-to-video generation
  • Cinematic motion

Use cases

AdsStoryboardsDemos

Pricing

Per video second$0.100
You pay pass-through · 5% applied at credit top-up, not per-call.
See API example →CompareAPI referenceSee usage ranking →

Collections

More video models →More from Tencent →Frontier models →Free-tier models →
API schema

Call Hunyuan Video Foley from any OpenAI SDK

POST https://api.aigateway.sh/v1/videos/generations·Content-Type: application/json·Auth: Bearer sk-aig-...

Request body

json
{
  "model": "tencent/hunyuan-video-foley",
  "prompt": "A drone shot of a mountain lake at golden hour",
  "duration": 5,          // seconds
  "aspect_ratio": "16:9"
}

// Response is an async job — poll /v1/jobs/<id> until status === "completed".

Response

json
{
  "id": "job_abc123",
  "status": "queued",        // queued | processing | completed | failed
  "model": "tencent/hunyuan-video-foley",
  "created": 1776947082
}

// After completion:
{
  "id": "job_abc123",
  "status": "completed",
  "result": {
    "url": "https://media.aigateway.sh/video/abc123.mp4",
    "duration": 5,
    "resolution": "1920x1080"
  }
}

Quickstart

# See docs at https://aigateway.sh/docs

Errors

401authentication_errorInvalid or missing API key
402insufficient_creditsWallet empty (PAYG only)
404not_foundUnknown model or endpoint
429rate_limit_errorOver per-minute limit — see Retry-After header
500server_errorUpstream provider failed (retryable)
503service_unavailableUpstream saturated (retryable)
Full docs →API reference →OpenAPI spec →llms.txt →

Frequently asked questions

What is Hunyuan Video Foley?
Use the capabilities of the hunyuan foley model to bring life to your videos by adding sound effect to them. It is a video model from Tencent, accessible via AIgateway's OpenAI-compatible API at slug tencent/hunyuan-video-foley.
How much does Hunyuan Video Foley cost via AIgateway?
Pass-through pricing plus a 5% platform fee applied at top-up. See the pricing panel on this page for exact rates.
How do I call Hunyuan Video Foley from my code?
Point the OpenAI SDK at https://api.aigateway.sh/v1 with your AIgateway key and set model to "tencent/hunyuan-video-foley". The request and response shapes match OpenAI exactly.
Does Hunyuan Video Foley support streaming, tool calling, vision, and JSON mode?
Streaming — no. Tool calling — no. Vision — no. JSON mode — no. Prompt caching — no.
What are the best use cases for Hunyuan Video Foley?
Ads, Storyboards, Demos. Key strengths: Text-to-video generation; Cinematic motion.
Can I bring my own Tencent API key (BYOK)?
Yes. Attach a Tencent key in your AIgateway dashboard and this model flips to pass-through — you pay Tencent directly and AIgateway waives the 5% platform fee on those calls.