--- title: "HeyGen Translate (speed)" description: "HeyGen Translate re-voices a finished video and moves the speaker's mouth to match the new language. The speed tier is the faster and cheaper of the two HeyGen lanes." url: https://docs.roasos.com/models/dub/heygen-speed --- # HeyGen Translate (speed) Family `dub` · model `heygen-speed` · catalog `model-catalog@2026-10-06.v5` · pricing `customer-pricing@2026-11-05.v15` . ## Endpoint ```http POST https://api.roasos.com/v1/dub/heygen-speed ``` Send your API key as a bearer token. The key needs the scope `api:write`. Every paid request also needs an `Idempotency-Key` header. The envelope fields `quote_only`, `quote_id`, `webhook_url` and `wait_timeout_seconds` behave the same on each model endpoint. Refer to [Jobs](/concepts/jobs) and [Quotes and credits](/concepts/quotes-and-credits). ## Good at Take a talking-head ad into a second market and keep it looking shot in that language. Use this tier for volume: many languages, quick turnaround, and lip-sync that is good rather than perfect. Use `heygen-precision` when one hero asset must hold up on a large screen. The price is $0.05 for each second of the OUTPUT video, not the input. roasOS quotes the input plus 25% and settles on the real output length, so the charge is at or below the number you saw and never above it. ## Pricing The unit is one **source\_second**. Pricing key: `heygen-speed`. | Request | Credits | | ------------- | ------- | | `30s_source` | 23 | | `60s_source` | 45 | | `120s_source` | 90 | The credits come from the roasOS pricing table. No other field changes the price. To get the exact price of your request, send it with `quote_only: true` first. ## Modes * `video-dub` Provider endpoints: `fal-ai/heygen/v2/translate/speed`. ## Request fields | Field | Type | Required | Default | Rule | | ------------------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `enable_dynamic_duration` | boolean | no | `false` | — | | `language` | enum | yes | — | `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` | | `quote_id` | string | no | — | UUID | | `quote_only` | boolean | no | `false` | — | | `speaker_count` | integer | no | — | 1–50 | | `translate_audio_only` | boolean | no | `false` | — | | `video_url` | string | yes | — | https URL; ≤ 4,096 characters | | `wait_timeout_seconds` | integer | no | `0` | 0–60 | | `webhook_url` | string | no | — | https URL; ≤ 4,096 characters | The schema is strict. A field that is not in this table gets `400 unsupported_option`. The field names are the roasOS role names. One role has one name in every family. ## Media This endpoint accepts these media roles: * `video_url` — the source video | Role | Items | Maximum size | Content types | Duration | | ----------- | ----- | ------------ | ------------- | -------- | | `video_url` | ≤ 1 | 100 MB | `video/mp4` | 0–480 s | Every other role is refused: `avatar_id`, `elements`, `product_id`, `product_images`, `references`, `reference_images`, `image_url`, `end_image_url`, `scene_id`, `scene_image`, `video_urls`, `audio_urls`, `audio_url`, `voice_id`. A refused role gets `400 unsupported_option`. Each media URL must be an immutable object on `https://cdn.roasos.com` that your workspace owns. Any other URL gets `400 reference_media_not_workspace_owned` . Refer to [Reference media and uploads](/concepts/reference-media) to learn how to put a file there. ## Prompt None. This model takes no prompt. Send `language` as one of the 178 written names the model publishes, such as `Spanish (Mexico)` or `Japanese (Japan)`. An ISO code is refused. Set `translate_audio_only` to true to leave every face untouched and change the voice track only. `enable_dynamic_duration` lets the output run longer than the input so a slower language still sounds natural. roasOS holds it off by default, because this endpoint bills the output. Turn it on when fluency matters more than the exact length, and expect the price to rise with the clip. ## Not exposed These catalog entries describe omitted inputs, pinned values and source constraints. They do not imply that the provider accepts every listed field. * `brand_glossary_id` — not accepted by this public endpoint. * `srt_url` — not accepted by this public endpoint. * `srt_role` — not accepted by this public endpoint. * `enable_caption` — pinned to `false`. ## Result The result kind is `video`. Always present: `url`. ```json { "data": { "id": "gen_…", "kind": "video", "model": "heygen-speed", "status": "completed", "result": { "url": "https://cdn.roasos.com/workspaces/ws_01/result" } } } ``` The files are immutable objects on `https://cdn.roasos.com`. A result URL is a valid media input for your next request. ## Example The three steps are always the same: quote, run, poll. cURL JavaScript Python ```bash # 1. Quote. Nothing is spent. curl -X POST https://api.roasos.com/v1/dub/heygen-speed \ -H "Authorization: Bearer roasos_sk_live_..." \ -H "Idempotency-Key: 0f1c9e2a-heygen-speed-0001" \ -H "Content-Type: application/json" \ -d '{"quote_only":true,"language":"English","video_url":"https://cdn.roasos.com/workspaces/ws_01/uploads/video_url.mp4"}' # 200 { "data": { "kind": "quote", "quote_id": "q_7Hk...", "credits": 23, "expires_at": "...", # "confirmation": { "model": "heygen-speed", "example": "30s_source" } } } # 2. Run. Same body, same Idempotency-Key, quote_id in place of quote_only. curl -X POST https://api.roasos.com/v1/dub/heygen-speed \ -H "Authorization: Bearer roasos_sk_live_..." \ -H "Idempotency-Key: 0f1c9e2a-heygen-speed-0001" \ -H "Content-Type: application/json" \ -d '{"quote_id":"q_7Hk...","language":"English","video_url":"https://cdn.roasos.com/workspaces/ws_01/uploads/video_url.mp4"}' # 201 { "data": { "id": "gen_...", "status": "queued", "credits_reserved": 23 } } # 3. Poll, then read the result. curl https://api.roasos.com/v1/jobs/gen_.../status -H "Authorization: Bearer roasos_sk_live_..." curl https://api.roasos.com/v1/jobs/gen_.../result -H "Authorization: Bearer roasos_sk_live_..." ``` ```javascript const key = process.env.ROASOS_API_KEY; const url = "https://api.roasos.com/v1/dub/heygen-speed"; const idempotencyKey = "0f1c9e2a-heygen-speed-0001"; const input = { "language": "English", "video_url": "https://cdn.roasos.com/workspaces/ws_01/uploads/video_url.mp4" }; const post = (payload) => fetch(url, { method: "POST", headers: { Authorization: `Bearer ${key}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json", }, body: JSON.stringify(payload), }).then((response) => response.json()); // 1. Quote. Nothing is spent. const quote = await post({ quote_only: true, ...input }); console.log(quote.data.credits); // 2. Run. const job = await post({ quote_id: quote.data.quote_id, ...input }); // 3. Poll, then read the result. let status = "queued"; while (status !== "completed" && status !== "failed" && status !== "canceled") { await new Promise((done) => setTimeout(done, 3000)); const poll = await fetch(`${url.split("/v1")[0]}/v1/jobs/${job.data.id}/status`, { headers: { Authorization: `Bearer ${key}` }, }).then((response) => response.json()); status = poll.data.status; } const result = await fetch(`${url.split("/v1")[0]}/v1/jobs/${job.data.id}/result`, { headers: { Authorization: `Bearer ${key}` }, }).then((response) => response.json()); console.log(result.data.result); ``` ```python import os, time, requests key = os.environ["ROASOS_API_KEY"] url = "https://api.roasos.com/v1/dub/heygen-speed" headers = { "Authorization": f"Bearer {key}", "Idempotency-Key": "0f1c9e2a-heygen-speed-0001", } payload = { "language": "English", "video_url": "https://cdn.roasos.com/workspaces/ws_01/uploads/video_url.mp4" } # 1. Quote. Nothing is spent. quote = requests.post(url, headers=headers, json={"quote_only": True, **payload}).json() print(quote["data"]["credits"]) # 2. Run. job = requests.post(url, headers=headers, json={"quote_id": quote["data"]["quote_id"], **payload}).json() job_id = job["data"]["id"] # 3. Poll, then read the result. jobs = "https://api.roasos.com/v1/jobs" status = "queued" while status not in ("completed", "failed", "canceled"): time.sleep(3) status = requests.get(f"{jobs}/{job_id}/status", headers=headers).json()["data"]["status"] result = requests.get(f"{jobs}/{job_id}/result", headers=headers).json() print(result["data"]["result"]) ``` ## Today `POST /v1/dub/heygen-speed` is the only path to this model. There is no deprecated alias: `POST /v1/generations` has no `dub` type, so the old path cannot reach this family at all. The source must be an MP4 your workspace owns, and at most 480 seconds — the maximum HeyGen states. ## See also * [`llms.txt` for this model](https://docs.roasos.com/models/dub/heygen-speed/llms.txt) — the same facts as one plain-text file for an agent. * `GET https://api.roasos.com/v1/catalog/heygen-speed` — the machine-readable form: enums, defaults, limits and prices. Refer to the [API reference](/api-reference/overview). * [Jobs](/concepts/jobs) — how to poll a job and read its result. * Provider endpoints: `fal-ai/heygen/v2/translate/speed`.