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.010

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

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"}'
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. 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.
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 adds no platform fee on those calls.