Video

Hunyuan Video Foley

Credit-based pricing. Supports reference video.

Try Hunyuan Video Foley →Compare models

Output

video

Inputs

Reference video (required)

Example prompt

Upload a silent video and describe the sounds — Hunyuan Video Foley uses Tencent's model to add cinematic audio tightly synced to on-screen action

Try this prompt →

LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/hunyuan-video-foley.

POST/api/v1/generate13 fields · 3 required

Field	Type	Requirement	Contract
`model_id`	constant	Required	ArtEmotion model identifier.
`extra`	object	Optional	Model-specific settings may also be nested here.
`max_credits`	number	Optional	Reject before submission if the estimated list price exceeds this cap. · Range: 1–…
`webhook_url`	string	Optional	Format: uri
`webhook_secret`	string	Optional	Optional model input.
`folder_id`	string	Optional	Optional model input.
`prompt`	string	Optional	Optional model input.
`text_prompt`	string	Required	Text description of the desired audio — describe sounds, ambience, instruments, etc.
`negative_prompt`	string	Optional	Negative prompt to avoid certain audio characteristics. · Default: noisy, harsh
`guidance_scale`	number	Optional	Guidance scale for audio generation. · Default: 4.5 · Range: 1–10
`num_inference_steps`	number	Optional	Number of inference steps for generation. · Default: 50 · Range: 10–100
`seed`	integer	Optional	Random seed for reproducible generation.
`video_url`	string	Required	Format: uri

Minimal request example

{
  "model_id": "fal-ai/hunyuan-video-foley",
  "text_prompt": "your_text_prompt",
  "video_url": "https://example.com/video"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fhunyuan-video-foley",
  "title": "Hunyuan Video Foley generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/hunyuan-video-foley.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/hunyuan-video-foley",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "text_prompt": {
      "title": "Text Prompt",
      "description": "Text description of the desired audio — describe sounds, ambience, instruments, etc.",
      "type": "string"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "Negative prompt to avoid certain audio characteristics.",
      "default": "noisy, harsh",
      "type": "string"
    },
    "guidance_scale": {
      "title": "Guidance Scale",
      "description": "Guidance scale for audio generation.",
      "default": 4.5,
      "type": "number",
      "minimum": 1,
      "maximum": 10,
      "multipleOf": 0.1
    },
    "num_inference_steps": {
      "title": "Num Inference Steps",
      "description": "Number of inference steps for generation.",
      "default": 50,
      "type": "number",
      "minimum": 10,
      "maximum": 100,
      "multipleOf": 1
    },
    "seed": {
      "title": "Seed",
      "description": "Random seed for reproducible generation.",
      "type": "integer"
    },
    "video_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "text_prompt",
    "video_url"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

How much does Hunyuan Video Foley cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Hunyuan Video Foley fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Hunyuan Video Foley from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/hunyuan-video-foley". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Hunyuan Video Foley?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.