# HeyGen v2 translate precision

Needs video url and output language. Served by fal.ai.

Heygen, served by fal.ai. The OpenAPI schema for the fal-ai/heygen/v2/translate/precision queue. Price: Your request will cost $0.1 per output video second. Actual-cost billing: the initial reservation is an estimate, not a maximum. 30 seconds at $0.1/s; actual input/output duration determines cost. The unique Billing Events receipt for this exact endpoint and request_id is the final USD charge, including usage above the estimate. Missing receipts retain the reservation for reconciliation; no guessed final fee. Asynchronous: returns a request_id; poll fal/status and fetch fal/result with model "fal-ai/heygen" and that request_id. Billed once, when the result is ready; a generation that fails is refunded.

- Tool ID: `fal/heygen-v2-translate-precision`
- Name in the catalog: Heygen
- Provider: [fal.ai](/providers/fal.md)
- Capability: [AI video generation](/tools/video-generation.md)
- Price: usage based, the maximum is shown before a run
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

Billed at the exact provider cost, without a per-call cap. The initial reservation is an estimate; additional usage is debited and unused funds are refunded.


```json
{
  "model": "reported",
  "costPath": "cost_usd",
  "requireCost": true,
  "costMode": "actual",
  "reservationBasis": "30 seconds at $0.1/s; actual input/output duration determines cost.",
  "maxUsdDefault": 3,
  "maxUsdCap": 3
}
```

Pricing source: [https://fal.ai/models/fal-ai/heygen/v2/translate/precision](https://fal.ai/models/fal-ai/heygen/v2/translate/precision). Your request will cost $0.1 per output video second. Actual-cost billing: the initial reservation is an estimate, not a maximum. 30 seconds at $0.1/s; actual input/output duration determines cost. The unique Billing Events receipt for this exact endpoint and request_id is the final USD charge, including usage above the estimate. Missing receipts retain the reservation for reconciliation; no guessed final fee..

Price verification date: 2026-10-07.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "enable_dynamic_duration": {
      "description": "Enable dynamic duration to enhance conversational fluidity between languages with different speaking rates",
      "default": true,
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Enable Dynamic Duration"
    },
    "enable_caption": {
      "description": "Generate an SRT caption file alongside the translated video.",
      "default": false,
      "type": "boolean",
      "title": "Enable Caption"
    },
    "speaker_num": {
      "description": "Number of speakers in the video",
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Speaker Num"
    },
    "output_language": {
      "type": "string",
      "description": "The target language to translate the video into",
      "enum": [
        "English",
        "Spanish",
        "French",
        "Hindi",
        "Italian",
        "German",
        "Polish",
        "Portuguese",
        "Chinese",
        "Japanese",
        "Dutch",
        "Turkish",
        "Korean",
        "Danish",
        "Arabic",
        "Romanian",
        "Mandarin",
        "Filipino",
        "Swedish",
        "Indonesian",
        "Ukrainian",
        "Greek",
        "Czech",
        "Bulgarian",
        "Malay",
        "Slovak",
        "Croatian",
        "Tamil",
        "Finnish",
        "Russian",
        "Afrikaans (South Africa)",
        "Albanian (Albania)",
        "Amharic (Ethiopia)",
        "Arabic (Algeria)",
        "Arabic (Bahrain)",
        "Arabic (Egypt)",
        "Arabic (Iraq)",
        "Arabic (Jordan)",
        "Arabic (Kuwait)",
        "Arabic (Lebanon)",
        "Arabic (Libya)",
        "Arabic (Morocco)",
        "Arabic (Oman)",
        "Arabic (Qatar)",
        "Arabic (Saudi Arabia)",
        "Arabic (Syria)",
        "Arabic (Tunisia)",
        "Arabic (United Arab Emirates)",
        "Arabic (Yemen)",
        "Armenian (Armenia)",
        "Azerbaijani (Latin, Azerbaijan)",
        "Bangla (Bangladesh)",
        "Basque",
        "Bengali (India)",
        "Bosnian (Bosnia and Herzegovina)",
        "Bulgarian (Bulgaria)",
        "Burmese (Myanmar)",
        "Catalan",
        "Chinese (Cantonese, Traditional)",
        "Chinese (Jilu Mandarin, Simplified)",
        "Chinese (Mandarin, Simplified)",
        "Chinese (Northeastern Mandarin, Simplified)",
        "Chinese (Southwestern Mandarin, Simplified)",
        "Chinese (Taiwanese Mandarin, Traditional)",
        "Chinese (Wu, Simplified)",
        "Chinese (Zhongyuan Mandarin Henan, Simplified)",
        "Chinese (Zhongyuan Mandarin Shaanxi, Simplified)",
        "Croatian (Croatia)",
        "Czech (Czechia)",
        "Danish (Denmark)",
        "Dutch (Belgium)",
        "Dutch (Netherlands)",
        "English (Australia)",
        "English (Canada)",
        "English (Hong Kong SAR)",
        "English (India)",
        "English (Ireland)",
        "English (Kenya)",
        "English (New Zealand)",
        "English (Nigeria)",
        "English (Philippines)",
        "English (Singapore)",
        "English (South Africa)",
        "English (Tanzania)",
        "English (UK)",
        "English (United States)",
        "Estonian (Estonia)",
        "Filipino (Philippines)",
        "Finnish (Finland)",
        "French (Belgium)",
        "French (Canada)",
        "French (France)",
        "French (Switzerland)",
        "Galician",
        "Georgian (Georgia)",
        "German (Austria)",
        "German (Germany)",
        "German (Switzerland)",
        "Greek (Greece)",
        "Gujarati (India)",
        "Hebrew (Israel)",
        "Hindi (India)",
        "Hungarian (Hungary)",
        "Icelandic (Iceland)",
        "Indonesian (Indonesia)",
        "Irish (Ireland)",
        "Italian (Italy)",
        "Japanese (Japan)",
        "Javanese (Latin, Indonesia)",
        "Kannada (India)",
        "Kazakh (Kazakhstan)",
        "Khmer (Cambodia)",
        "Korean (Korea)",
        "Lao (Laos)",
        "Latvian (Latvia)",
        "Lithuanian (Lithuania)",
        "Macedonian (North Macedonia)",
        "Malay (Malaysia)",
        "Malayalam (India)",
        "Maltese (Malta)",
        "Marathi (India)",
        "Mongolian (Mongolia)",
        "Nepali (Nepal)",
        "Norwegian Bokmål (Norway)",
        "Pashto (Afghanistan)",
        "Persian (Iran)",
        "Polish (Poland)",
        "Portuguese (Brazil)",
        "Portuguese (Portugal)",
        "Romanian (Romania)",
        "Russian (Russia)",
        "Serbian (Latin, Serbia)",
        "Sinhala (Sri Lanka)",
        "Slovak (Slovakia)",
        "Slovenian (Slovenia)",
        "Somali (Somalia)",
        "Spanish (Argentina)",
        "Spanish (Bolivia)",
        "Spanish (Chile)",
        "Spanish (Colombia)",
        "Spanish (Costa Rica)",
        "Spanish (Cuba)",
        "Spanish (Dominican Republic)",
        "Spanish (Ecuador)",
        "Spanish (El Salvador)",
        "Spanish (Equatorial Guinea)",
        "Spanish (Guatemala)",
        "Spanish (Honduras)",
        "Spanish (Mexico)",
        "Spanish (Nicaragua)",
        "Spanish (Panama)",
        "Spanish (Paraguay)",
        "Spanish (Peru)",
        "Spanish (Puerto Rico)",
        "Spanish (Spain)",
        "Spanish (United States)",
        "Spanish (Uruguay)",
        "Spanish (Venezuela)",
        "Sundanese (Indonesia)",
        "Swahili (Kenya)",
        "Swahili (Tanzania)",
        "Swedish (Sweden)",
        "Tamil (India)",
        "Tamil (Malaysia)",
        "Tamil (Singapore)",
        "Tamil (Sri Lanka)",
        "Telugu (India)",
        "Thai (Thailand)",
        "Turkish (Türkiye)",
        "Ukrainian (Ukraine)",
        "Urdu (India)",
        "Urdu (Pakistan)",
        "Uzbek (Latin, Uzbekistan)",
        "Vietnamese (Vietnam)",
        "Welsh (United Kingdom)",
        "Zulu (South Africa)",
        "English - Your Accent",
        "English - American Accent"
      ],
      "title": "Output Language"
    },
    "translate_audio_only": {
      "description": "Translate only the audio, ignore the faces and only translate the voice track",
      "default": false,
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Translate Audio Only"
    },
    "video_url": {
      "type": "string",
      "description": "URL of the video to translate. Maximum length is 8 minutes.",
      "title": "Video Url"
    },
    "srt_url": {
      "description": "Optional URL of a custom SRT subtitle file.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Srt Url"
    },
    "brand_glossary_id": {
      "description": "HeyGen brand glossary ID for custom term translations.",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Brand Glossary Id"
    },
    "srt_role": {
      "description": "Whether the custom SRT applies to the source or translated video.",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "input",
            "output"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Srt Role"
    }
  },
  "required": [
    "video_url",
    "output_language"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "fal/heygen-v2-translate-precision",
  "input": {
    "video_url": "https://v3b.fal.media/files/b/0a9004c7/FM7Q5tK2b59x66Bl8HC0Z_vt-lang-en.mp4",
    "output_language": "Spanish"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://fal.ai/models/fal-ai/heygen/v2/translate/precision)

[REST inspection](https://api.agentik.cc/v1/tools/fal/heygen-v2-translate-precision) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/fal/heygen-v2-translate-precision) · [Agent index](/llms.txt)