Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.
{
"error": {
"code": "invalid_parameter",
"message": "Invalid payload(s) at index 3.",
"param": "video_translations",
"doc_url": null
}
}
{
"error": {
"code": "unauthorized",
"message": "Invalid or expired API key. Verify your x-api-key header.",
"param": null,
"doc_url": null
}
}
{
"error": {
"code": "request_in_progress",
"message": "A request with this Idempotency-Key is already in progress. Retry shortly.",
"param": null,
"doc_url": null
}
}
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the duration specified in the Retry-After header.",
"param": null,
"doc_url": null
}
}
Authorizations
ApiKeyAuthBearerAuth
x-api-key
string
header
required
HeyGen API key. Obtain from your HeyGen dashboard.
Headers
Idempotency-Key
string
Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.
Required string length: 1 - 255
Pattern: ^[A-Za-z0-9_\-:.]{1,255}$
Body
application/json
video_translations
CreateVideoTranslationRequest · object[]
required
Video-translation payloads, identical in shape to POST /v3/video-translations. A single entry targeting multiple output_languages expands to one batch item per language; the expanded item count is capped at 100.
Required array length: 1 - 100 elements
Show child attributes
title
string | null
Display name for the batch, shown in the HeyGen app.
callback_url
string | null
Webhook URL invoked once when every item in the batch reaches a terminal state.
Response
Accepted — submission acknowledged; poll for completion.
{
"error": {
"code": "invalid_parameter",
"message": "Invalid payload(s) at index 3.",
"param": "video_translations",
"doc_url": null
}
}
{
"error": {
"code": "unauthorized",
"message": "Invalid or expired API key. Verify your x-api-key header.",
"param": null,
"doc_url": null
}
}
{
"error": {
"code": "request_in_progress",
"message": "A request with this Idempotency-Key is already in progress. Retry shortly.",
"param": null,
"doc_url": null
}
}
{
"error": {
"code": "rate_limit_exceeded",
"message": "Too many requests. Retry after the duration specified in the Retry-After header.",
"param": null,
"doc_url": null
}
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"HeyGen Documentation","colors":{"primary":"#03C3FF","light":"#03C3FF","dark":"#03C3FF"},"logo":{"light":"https://mintcdn.com/heygen-1fa696a7/dQ_uLJDftFYFhC7B/logo/light.png?fit=max\u0026auto=format\u0026n=dQ_uLJDftFYFhC7B\u0026q=85\u0026s=b03d2e41dde1cc0b50cd50e574f66f1c","dark":"https://mintcdn.com/heygen-1fa696a7/dQ_uLJDftFYFhC7B/logo/dark.png?fit=max\u0026auto=format\u0026n=dQ_uLJDftFYFhC7B\u0026q=85\u0026s=1bce9897c94baace249bfc9bd5ebb894"},"favicon":{"light":"https://mintcdn.com/heygen-1fa696a7/eIkZ-KhF8P1D-58U/images/fav.png?fit=max\u0026auto=format\u0026n=eIkZ-KhF8P1D-58U\u0026q=85\u0026s=974346d2956697dca817da145b0107e8","dark":"https://mintcdn.com/heygen-1fa696a7/eIkZ-KhF8P1D-58U/images/fav.png?fit=max\u0026auto=format\u0026n=eIkZ-KhF8P1D-58U\u0026q=85\u0026s=974346d2956697dca817da145b0107e8"},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://platform.heygen.com"}},"seo":{"metatags":{"robots":"index, follow"},"indexing":"navigable"},"fonts":{"heading":{"family":"ABC Solar Display","source":"https://www-static-assets.heygen.com/fonts/solar-display/ABCSolarDisplay-Bold.woff2","format":"woff2"},"body":{"family":"TT Norms Pro","source":"https://www-static-assets.heygen.com/fonts/tt-norms/TT_Norms_Pro_Normal.woff2","format":"woff2"}},"integrations":{"posthog":{"apiKey":"phc_bcoaBa4uZdMp0CzXr7QhZRRpnNGgBRRZ1GStvuJVAgJ","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude","grok","cursor"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"heygen-1fa696a7","hasAudioNarration":false,"actualSubdomain":"heygen-1fa696a7","customDomains":[],"gitSource":{"type":"github","owner":"heygen-com","repo":"api-docs","deployBranch":"master","contentDirectory":"heygen-api","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b023b5c34aba046b8adc5d2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":118},{"language":"default","tag":"Developer Guide","count":89},{"language":"default","tag":"Avatar","count":32},{"language":"default","tag":"Video editing","count":30},{"language":"default","tag":"Video","count":23},{"language":"default","tag":"Brand","count":19},{"language":"default","tag":"Voice","count":18},{"language":"default","tag":"Platform","count":17},{"language":"default","tag":"Batches","count":17},{"language":"default","tag":"Video Agent","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"li[id=\"https://platform.heygen.com\"]>a,.lg\\:hidden>a[href=\"https://platform.heygen.com\"]{color:#03C3FF!important;font-weight:600}li[id=\"https://platform.heygen.com\"]>a svg,.lg\\:hidden>a[href=\"https://platform.heygen.com\"] svg{color:#03C3FF!important}#hg-platform-links{position:absolute;top:0;right:calc(var(--sidebar-width, 19rem) + 24px);height:48px;display:flex;align-items:center;gap:6px;z-index:30}@media (max-width: 1023px){#hg-platform-links{display:none}}#hg-platform-links .hg-pill{display:inline-flex;align-items:center;gap:5px;height:24px;padding:0 10px;border-radius:999px;font-size:11.5px;font-weight:500;line-height:1;white-space:nowrap;text-decoration:none;color:rgb(55 65 81);border:1px solid rgb(3 7 18 / 0.1);background:rgb(3 7 18 / 0.02);transition:color 0.15s, border-color 0.15s, background 0.15s, box-shadow 0.15s}#hg-platform-links .hg-pill svg{width:12px;height:12px;fill:none;stroke:currentColor;stroke-width:2;stroke-linecap:round;stroke-linejoin:round}#hg-platform-links .hg-pill:hover{color:#0284c7;border-color:rgb(3 195 255 / 0.5);background:rgb(3 195 255 / 0.06)}#hg-platform-links .hg-pill--primary{color:#03131a;border-color:transparent;background:linear-gradient(90deg, #03C3FF, #7CF5C4);font-weight:600}#hg-platform-links .hg-pill--primary svg{fill:currentColor;stroke:none}#hg-platform-links .hg-pill--primary:hover{color:#03131a;border-color:transparent;background:linear-gradient(90deg, #03C3FF, #7CF5C4);box-shadow:0 0 0 3px rgb(3 195 255 / 0.18), 0 0 18px rgb(3 195 255 / 0.35)}html.dark #hg-platform-links .hg-pill:not(.hg-pill--primary){color:rgb(209 213 219);border-color:rgb(255 255 255 / 0.1);background:rgb(255 255 255 / 0.03)}html.dark #hg-platform-links .hg-pill:not(.hg-pill--primary):hover{color:#03C3FF;border-color:rgb(3 195 255 / 0.45);background:rgb(3 195 255 / 0.08)}@media (max-width: 1439px){#hg-platform-links .hg-pill:not(.hg-pill--primary){width:24px;padding:0;justify-content:center}#hg-platform-links .hg-pill:not(.hg-pill--primary) span{display:none}}@media (max-width: 1179px){#hg-platform-links .hg-pill:not(.hg-pill--primary){display:none}}"}]}
{"page":{"pagePath":"reference/create-video-translation-batch","slug":"/reference/create-video-translation-batch","pageMetadata":{"title":"Create Video Translation Batch","description":"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several `output_languages` becomes one item per language, and items run independently. Returns 202 with a `batch_id` to poll. Send an Idempotency-Key to make retries safe.","deprecated":null,"version":null,"sidebarTitle":"Create video translation batch","openapi":"/openapi/external-api.json post /v3/video-translations/batches","href":"/reference/create-video-translation-batch","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several \", _jsx(_components.code, {\n children: \"output_languages\"\n }), \" becomes one item per language, and items run independently. Returns 202 with a \", _jsx(_components.code, {\n children: \"batch_id\"\n }), \" to poll. Send an Idempotency-Key to make retries safe.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Video Translation Batch","description":"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several `output_languages` becomes one item per language, and items run independently. Returns 202 with a `batch_id` to poll. Send an Idempotency-Key to make retries safe.","deprecated":null,"version":null,"sidebarTitle":"Create video translation batch","openapi":"/openapi/external-api.json post /v3/video-translations/batches","href":"/reference/create-video-translation-batch","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/heygen-1fa696a7/5ff79916e1e2679a/platform-links.js"],"openApiReferenceData":{"operation":{"summary":"Create Video Translation Batch","description":"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several `output_languages` becomes one item per language, and items run independently. Returns 202 with a `batch_id` to poll. Send an Idempotency-Key to make retries safe.","tags":["Batches"],"security":["273e43b5-5c2f-49ed-94ee-1f82159e49b3","1eaff886-a094-4f6b-8b35-b21c65432411"],"responses":{"202":"ec816bdc-ceca-47a0-a6e8-1da4e3415744","400":"da0d40d7-3995-4701-8449-554825f138a8","401":"7f41396b-b89a-41dc-a971-8a9f4ab9485d","409":"caf649ad-a94b-4942-89e7-65e17e711ca1","429":"e3096d9e-a3ea-4aaf-b486-acf995b56c12"},"x-mint":{"href":"/reference/create-video-translation-batch"},"operationId":"createVideoTranslationBatchV3","parameters":["88d56a4c-2fc6-4083-abfc-d109691dfe34"],"requestBody":"94532698-b039-4ded-8de4-b203c6eeace1","x-heygen-required-scopes":["translations:write"],"method":"post","type":"path","servers":["e6cd17e6-82b7-4d18-b2e2-af0f350698c3"],"path":"/v3/video-translations/batches","baseUrlOptions":["https://api.heygen.com"],"title":"Create Video Translation Batch","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"88d56a4c-2fc6-4083-abfc-d109691dfe34":{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 `request_in_progress`. Keys must be 1–255 characters from `[A-Za-z0-9_:.-]`; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.","schema":{"type":"string","pattern":"^[A-Za-z0-9_\\-:.]{1,255}$","maxLength":255,"minLength":1,"isRequired":false,"description":"Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 `request_in_progress`. Keys must be 1–255 characters from `[A-Za-z0-9_:.-]`; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.","uniqueKey":"","typeLabel":"string"},"example":"550e8400-e29b-41d4-a716-446655440000"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"video_translations":{"description":"Video-translation payloads, identical in shape to POST /v3/video-translations. A single entry targeting multiple output_languages expands to one batch item per language; the expanded item count is capped at 100.","items":{"additionalProperties":false,"description":"Request body for POST /v3/video-translations.","properties":{"video":{"oneOf":[{"type":"object","title":"AssetUrl","description":"Asset input via publicly accessible HTTPS URL.","required":["type","url"],"properties":{"type":{"const":"url","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.0.type","typeLabel":"string"},"url":{"description":"Public http(s) URL HeyGen can download without auth or redirects. Not a local or sandbox path (/mnt/data/..., file://, sandbox:); upload such files and pass asset_id.","title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.0","typeLabel":"AssetUrl · object"},{"type":"object","title":"AssetId","description":"Asset input via HeyGen asset ID from the asset upload endpoint.","required":["type","asset_id"],"properties":{"type":{"const":"asset_id","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.1.type","typeLabel":"string"},"asset_id":{"description":"HeyGen asset ID from an asset upload or import; not a third-party file ID.","title":"Asset Id","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.1.asset_id","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video.oneOf.1","typeLabel":"AssetId · object"}],"isRequired":true,"uniqueKey":"video_translations.items.[INDEX].video","typeLabel":"AssetUrl · object | AssetId · object"},"output_languages":{"description":"Target language names (e.g. 'Chinese (Cantonese, Traditional)', 'Spanish (Spain)', 'English'). Use GET /v3/video-translations/languages for valid values. Use one for single translation, multiple for batch.","items":{"type":"string","uniqueKey":"video_translations.items.[INDEX].output_languages.items.[INDEX]","typeLabel":"string"},"minItems":1,"title":"Output Languages","type":"array","x-mcp-schema":{"description":"Target language names, e.g. 'English', 'Spanish', 'Hindi'. Use a name from the available_on_current_plan field of GET /v3/video-translations/languages. Most premium dialect voices have a region in brackets (e.g. 'Hindi (India)') and aren't on the free plan, so prefer the plain name unless the user asked for a specific accent. Use one for single translation, multiple for batch."},"isRequired":true,"uniqueKey":"video_translations.items.[INDEX].output_languages","typeLabel":"string[]"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Title for the translation job","uniqueKey":"video_translations.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Title for the translation job","uniqueKey":"video_translations.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].title","typeLabel":"string | null"},"audio":{"oneOf":[{"type":"object","title":"AssetUrl","description":"Asset input via publicly accessible HTTPS URL.","required":["type","url"],"properties":{"type":{"const":"url","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.0.type","typeLabel":"string"},"url":{"description":"Public http(s) URL HeyGen can download without auth or redirects. Not a local or sandbox path (/mnt/data/..., file://, sandbox:); upload such files and pass asset_id.","title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.0","typeLabel":"AssetUrl · object"},{"type":"object","title":"AssetId","description":"Asset input via HeyGen asset ID from the asset upload endpoint.","required":["type","asset_id"],"properties":{"type":{"const":"asset_id","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.1.type","typeLabel":"string"},"asset_id":{"description":"HeyGen asset ID from an asset upload or import; not a third-party file ID.","title":"Asset Id","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.1.asset_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].audio.oneOf.1","typeLabel":"AssetId · object"},{"type":"null","title":"Audio","description":"Custom audio for dubbing — provide as {type: 'url', url: '...'} or {type: 'asset_id', asset_id: '...'}","uniqueKey":"video_translations.items.[INDEX].audio.oneOf.2","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].audio","typeLabel":"AssetUrl · object | AssetId · object | null"},"input_language":{"oneOf":[{"type":"string","title":"Input Language","description":"Source language name, e.g. 'English' (auto-detected if omitted)","x-mcp-visible":false,"uniqueKey":"video_translations.items.[INDEX].input_language.oneOf.0","typeLabel":"string"},{"type":"null","title":"Input Language","description":"Source language name, e.g. 'English' (auto-detected if omitted)","x-mcp-visible":false,"uniqueKey":"video_translations.items.[INDEX].input_language.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].input_language","typeLabel":"string | null"},"translate_audio_only":{"default":false,"description":"Only translate audio, keep original video","title":"Translate Audio Only","type":"boolean","uniqueKey":"video_translations.items.[INDEX].translate_audio_only","typeLabel":"boolean"},"speaker_num":{"oneOf":[{"type":"integer","title":"Speaker Num","description":"Number of speakers (improves speaker separation)","uniqueKey":"video_translations.items.[INDEX].speaker_num.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Speaker Num","description":"Number of speakers (improves speaker separation)","uniqueKey":"video_translations.items.[INDEX].speaker_num.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].speaker_num","typeLabel":"integer | null"},"mode":{"enum":["speed","precision"],"title":"VideoTranslationMode","type":"string","default":"speed","description":"Translation quality mode: 'speed' (faster) or 'precision' (higher quality, uses avatar inference)","uniqueKey":"video_translations.items.[INDEX].mode","typeLabel":"enum\u003cstring>"},"callback_url":{"oneOf":[{"type":"string","title":"Callback Url","description":"Webhook URL for completion notifications","uniqueKey":"video_translations.items.[INDEX].callback_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Callback Url","description":"Webhook URL for completion notifications","uniqueKey":"video_translations.items.[INDEX].callback_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].callback_url","typeLabel":"string | null"},"callback_id":{"oneOf":[{"type":"string","title":"Callback Id","description":"ID included in webhook payload","uniqueKey":"video_translations.items.[INDEX].callback_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Callback Id","description":"ID included in webhook payload","uniqueKey":"video_translations.items.[INDEX].callback_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].callback_id","typeLabel":"string | null"},"output_uploads":{"oneOf":[{"type":"object","title":"Output Uploads","description":"Upload each translated video's files straight into your own storage, keyed by a language from output_languages. Give a presigned PUT URL per file, for Amazon S3, Google Cloud Storage or Azure Blob Storage; HeyGen uploads each file when that language finishes. Languages without an entry are not uploaded. Not available with audio input or in batches. Available to enabled workspaces.","x-cli-visible":false,"x-mcp-visible":false,"additionalProperties":{"additionalProperties":false,"description":"Where the finished files go. Each file needs its own URL.","properties":{"video":{"additionalProperties":false,"properties":{"url":{"description":"A presigned PUT URL for Amazon S3, Google Cloud Storage or Azure Blob Storage, signed for the object key this file should land at. It must stay valid for at least one hour; 24 hours or more is recommended, because the file is uploaded when the video finishes.","maxLength":4096,"title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.video.url","typeLabel":"string"},"headers":{"additionalProperties":{"type":"string","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.video.headers.additionalProperties","typeLabel":"string"},"description":"Headers the URL was signed with, sent exactly as given. Allowed: Content-Type, Content-MD5, Content-Disposition, Content-Encoding, Content-Language, Cache-Control, and x-amz-*, x-goog-* or x-ms-* headers.","title":"Headers","type":"object","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.video.headers","typeLabel":"Headers · object"}},"required":["url"],"title":"UploadTargetRequest","type":"object","description":"Upload target for the finished video file.","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.video","typeLabel":"UploadTargetRequest · object"},"captions":{"oneOf":[{"type":"object","title":"UploadTargetRequest","description":"Upload target for the caption file, when the video has captions.","required":["url"],"properties":{"url":{"description":"A presigned PUT URL for Amazon S3, Google Cloud Storage or Azure Blob Storage, signed for the object key this file should land at. It must stay valid for at least one hour; 24 hours or more is recommended, because the file is uploaded when the video finishes.","maxLength":4096,"title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions.oneOf.0.url","typeLabel":"string"},"headers":{"additionalProperties":{"type":"string","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions.oneOf.0.headers.additionalProperties","typeLabel":"string"},"description":"Headers the URL was signed with, sent exactly as given. Allowed: Content-Type, Content-MD5, Content-Disposition, Content-Encoding, Content-Language, Cache-Control, and x-amz-*, x-goog-* or x-ms-* headers.","title":"Headers","type":"object","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions.oneOf.0.headers","typeLabel":"Headers · object"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions.oneOf.0","typeLabel":"UploadTargetRequest · object"},{"type":"null","description":"Upload target for the caption file, when the video has captions.","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.captions","typeLabel":"UploadTargetRequest · object | null"},"thumbnail":{"oneOf":[{"type":"object","title":"UploadTargetRequest","description":"Upload target for the thumbnail image.","required":["url"],"properties":{"url":{"description":"A presigned PUT URL for Amazon S3, Google Cloud Storage or Azure Blob Storage, signed for the object key this file should land at. It must stay valid for at least one hour; 24 hours or more is recommended, because the file is uploaded when the video finishes.","maxLength":4096,"title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail.oneOf.0.url","typeLabel":"string"},"headers":{"additionalProperties":{"type":"string","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail.oneOf.0.headers.additionalProperties","typeLabel":"string"},"description":"Headers the URL was signed with, sent exactly as given. Allowed: Content-Type, Content-MD5, Content-Disposition, Content-Encoding, Content-Language, Cache-Control, and x-amz-*, x-goog-* or x-ms-* headers.","title":"Headers","type":"object","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail.oneOf.0.headers","typeLabel":"Headers · object"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail.oneOf.0","typeLabel":"UploadTargetRequest · object"},{"type":"null","description":"Upload target for the thumbnail image.","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties.thumbnail","typeLabel":"UploadTargetRequest · object | null"}},"required":["video"],"title":"OutputUploadRequest","type":"object","uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0.additionalProperties","typeLabel":"OutputUploadRequest · object"},"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.0","typeLabel":"Output Uploads · object"},{"type":"null","title":"Output Uploads","description":"Upload each translated video's files straight into your own storage, keyed by a language from output_languages. Give a presigned PUT URL per file, for Amazon S3, Google Cloud Storage or Azure Blob Storage; HeyGen uploads each file when that language finishes. Languages without an entry are not uploaded. Not available with audio input or in batches. Available to enabled workspaces.","x-cli-visible":false,"x-mcp-visible":false,"uniqueKey":"video_translations.items.[INDEX].output_uploads.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].output_uploads","typeLabel":"Output Uploads · object | null"},"enable_caption":{"default":false,"deprecated":true,"description":"Deprecated and ignored: captions are always generated; whether to display them is a download-side choice.","title":"Enable Caption","type":"boolean","uniqueKey":"video_translations.items.[INDEX].enable_caption","typeLabel":"boolean"},"keep_the_same_format":{"oneOf":[{"type":"boolean","title":"Keep The Same Format","description":"Preserve the source video's encoding specs (resolution, bitrate).","uniqueKey":"video_translations.items.[INDEX].keep_the_same_format.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Keep The Same Format","description":"Preserve the source video's encoding specs (resolution, bitrate).","uniqueKey":"video_translations.items.[INDEX].keep_the_same_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].keep_the_same_format","typeLabel":"boolean | null"},"enable_dynamic_duration":{"default":true,"description":"Allow dynamic duration adjustment","title":"Enable Dynamic Duration","type":"boolean","uniqueKey":"video_translations.items.[INDEX].enable_dynamic_duration","typeLabel":"boolean"},"disable_music_track":{"default":false,"description":"Remove background music","title":"Disable Music Track","type":"boolean","uniqueKey":"video_translations.items.[INDEX].disable_music_track","typeLabel":"boolean"},"enable_speech_enhancement":{"default":false,"description":"Enhance speech quality","title":"Enable Speech Enhancement","type":"boolean","uniqueKey":"video_translations.items.[INDEX].enable_speech_enhancement","typeLabel":"boolean"},"enable_watermark":{"default":false,"description":"Add watermark to output","title":"Enable Watermark","type":"boolean","uniqueKey":"video_translations.items.[INDEX].enable_watermark","typeLabel":"boolean"},"start_time":{"oneOf":[{"type":"number","title":"Start Time","description":"Start time in seconds for partial translation","uniqueKey":"video_translations.items.[INDEX].start_time.oneOf.0","typeLabel":"number"},{"type":"null","title":"Start Time","description":"Start time in seconds for partial translation","uniqueKey":"video_translations.items.[INDEX].start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].start_time","typeLabel":"number | null"},"end_time":{"oneOf":[{"type":"number","title":"End Time","description":"End time in seconds for partial translation","uniqueKey":"video_translations.items.[INDEX].end_time.oneOf.0","typeLabel":"number"},{"type":"null","title":"End Time","description":"End time in seconds for partial translation","uniqueKey":"video_translations.items.[INDEX].end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].end_time","typeLabel":"number | null"},"brand_voice_id":{"oneOf":[{"type":"string","title":"Brand Voice Id","description":"Brand glossary ID for custom term translations. Legacy field name for `brand_glossary_id` — both are accepted and resolve to the same workspace record. Discover IDs via GET /v3/brand-glossaries.","deprecated":true,"uniqueKey":"video_translations.items.[INDEX].brand_voice_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Brand Voice Id","description":"Brand glossary ID for custom term translations. Legacy field name for `brand_glossary_id` — both are accepted and resolve to the same workspace record. Discover IDs via GET /v3/brand-glossaries.","deprecated":true,"uniqueKey":"video_translations.items.[INDEX].brand_voice_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].brand_voice_id","typeLabel":"string | null"},"brand_glossary_id":{"oneOf":[{"type":"string","title":"Brand Glossary Id","description":"Brand glossary ID for custom term translations (e.g. translate 'Reformer' as the Pilates equipment, not 'political activist'). Alias for the legacy `brand_voice_id` field. Discover IDs via GET /v3/brand-glossaries.","uniqueKey":"video_translations.items.[INDEX].brand_glossary_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Brand Glossary Id","description":"Brand glossary ID for custom term translations (e.g. translate 'Reformer' as the Pilates equipment, not 'political activist'). Alias for the legacy `brand_voice_id` field. Discover IDs via GET /v3/brand-glossaries.","uniqueKey":"video_translations.items.[INDEX].brand_glossary_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].brand_glossary_id","typeLabel":"string | null"},"stock_voice_config":{"oneOf":[{"type":"object","title":"StockVoiceConfig","description":"Use a preset stock voice for the translation instead of recreating the original speaker's voice. By default, Video Translation clones the original speaker so the result sounds like them; with this enabled, the translation is spoken by a natural preset voice optimized for clear pronunciation and accent in the target language (the result will not sound like the original speaker). Enterprise feature, available for selected accounts and languages by request — contact your HeyGen account team.","x-mcp-visible":false,"properties":{"use_stock_voice":{"default":false,"description":"Set to true to use a preset stock voice instead of cloning the original speaker.","title":"Use Stock Voice","type":"boolean","uniqueKey":"video_translations.items.[INDEX].stock_voice_config.oneOf.0.use_stock_voice","typeLabel":"boolean"},"preferred_stock_voice_ids":{"description":"Optional. Pin specific stock voice IDs to draw from. If omitted, the target language's default stock-voice pool is used.","items":{"type":"string","uniqueKey":"video_translations.items.[INDEX].stock_voice_config.oneOf.0.preferred_stock_voice_ids.items.[INDEX]","typeLabel":"string"},"title":"Preferred Stock Voice Ids","type":"array","uniqueKey":"video_translations.items.[INDEX].stock_voice_config.oneOf.0.preferred_stock_voice_ids","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].stock_voice_config.oneOf.0","typeLabel":"StockVoiceConfig · object"},{"type":"null","description":"Use a preset stock voice for the translation instead of recreating the original speaker's voice. By default, Video Translation clones the original speaker so the result sounds like them; with this enabled, the translation is spoken by a natural preset voice optimized for clear pronunciation and accent in the target language (the result will not sound like the original speaker). Enterprise feature, available for selected accounts and languages by request — contact your HeyGen account team.","x-mcp-visible":false,"uniqueKey":"video_translations.items.[INDEX].stock_voice_config.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].stock_voice_config","typeLabel":"StockVoiceConfig · object | null"},"srt":{"oneOf":[{"type":"object","title":"AssetUrl","description":"Asset input via publicly accessible HTTPS URL.","required":["type","url"],"properties":{"type":{"const":"url","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.0.type","typeLabel":"string"},"url":{"description":"Public http(s) URL HeyGen can download without auth or redirects. Not a local or sandbox path (/mnt/data/..., file://, sandbox:); upload such files and pass asset_id.","title":"Url","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.0","typeLabel":"AssetUrl · object"},{"type":"object","title":"AssetId","description":"Asset input via HeyGen asset ID from the asset upload endpoint.","required":["type","asset_id"],"properties":{"type":{"const":"asset_id","description":"Input type discriminator","title":"Type","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.1.type","typeLabel":"string"},"asset_id":{"description":"HeyGen asset ID from an asset upload or import; not a third-party file ID.","title":"Asset Id","type":"string","isRequired":true,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.1.asset_id","typeLabel":"string"}},"additionalProperties":false,"uniqueKey":"video_translations.items.[INDEX].srt.oneOf.1","typeLabel":"AssetId · object"},{"type":"null","title":"Srt","description":"Custom subtitle file — provide as {type: 'url', url: '...'} or {type: 'asset_id', asset_id: '...'}.","uniqueKey":"video_translations.items.[INDEX].srt.oneOf.2","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].srt","typeLabel":"AssetUrl · object | AssetId · object | null"},"srt_role":{"oneOf":[{"type":"string","title":"Srt Role","description":"Which video the subtitle applies to: 'input' (source) or 'output' (translated).","enum":["input","output"],"uniqueKey":"video_translations.items.[INDEX].srt_role.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Srt Role","description":"Which video the subtitle applies to: 'input' (source) or 'output' (translated).","uniqueKey":"video_translations.items.[INDEX].srt_role.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].srt_role","typeLabel":"enum\u003cstring> | null"},"fps_mode":{"oneOf":[{"type":"string","title":"Fps Mode","description":"Frame rate mode for the output video. 'vfr' = variable frame rate, 'cfr' = constant frame rate, 'passthrough' = match the source. Only takes effect when a custom 'audio' track is provided.","enum":["vfr","cfr","passthrough"],"uniqueKey":"video_translations.items.[INDEX].fps_mode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Fps Mode","description":"Frame rate mode for the output video. 'vfr' = variable frame rate, 'cfr' = constant frame rate, 'passthrough' = match the source. Only takes effect when a custom 'audio' track is provided.","uniqueKey":"video_translations.items.[INDEX].fps_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].fps_mode","typeLabel":"enum\u003cstring> | null"},"folder_id":{"oneOf":[{"type":"string","title":"Folder Id","description":"Destination folder ID in the caller's workspace, for example one returned by POST /v3/folders. Omit, pass null, or pass an empty string to place the result at the workspace root. The id must name a folder that is not in the trash and that the caller can write to. Assets library folders are accepted, but the HeyGen app files only assets in them, so a result placed there may not appear in the Assets library view. An unknown id, a folder in another workspace, a project of another kind such as a brand kit, or a trashed folder is rejected with 404 before anything is created.","uniqueKey":"video_translations.items.[INDEX].folder_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Folder Id","description":"Destination folder ID in the caller's workspace, for example one returned by POST /v3/folders. Omit, pass null, or pass an empty string to place the result at the workspace root. The id must name a folder that is not in the trash and that the caller can write to. Assets library folders are accepted, but the HeyGen app files only assets in them, so a result placed there may not appear in the Assets library view. An unknown id, a folder in another workspace, a project of another kind such as a brand kit, or a trashed folder is rejected with 404 before anything is created.","uniqueKey":"video_translations.items.[INDEX].folder_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"video_translations.items.[INDEX].folder_id","typeLabel":"string | null"}},"required":["video","output_languages"],"title":"CreateVideoTranslationRequest","type":"object","uniqueKey":"video_translations.items.[INDEX]","typeLabel":"CreateVideoTranslationRequest · object"},"maxItems":100,"minItems":1,"title":"Video Translations","type":"array","isRequired":true,"uniqueKey":"video_translations","typeLabel":"CreateVideoTranslationRequest · object[]"},"title":{"oneOf":[{"type":"string","title":"Title","description":"Display name for the batch, shown in the HeyGen app.","uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Title","description":"Display name for the batch, shown in the HeyGen app.","uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"callback_url":{"oneOf":[{"type":"string","title":"Callback Url","description":"Webhook URL invoked once when every item in the batch reaches a terminal state.","uniqueKey":"callback_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Callback Url","description":"Webhook URL invoked once when every item in the batch reaches a terminal state.","uniqueKey":"callback_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"callback_url","typeLabel":"string | null"}},"required":["video_translations"],"title":"CreateVideoTranslationBatchRequest","type":"object","uniqueKey":"","typeLabel":"CreateVideoTranslationBatchRequest · object"},"examples":{"Example":{"title":"Example","value":{"video_translations":[{"video":{"type":"url","url":"\u003cstring>"},"output_languages":["\u003cstring>"],"title":"\u003cstring>","audio":{"type":"url","url":"\u003cstring>"},"input_language":"\u003cstring>","translate_audio_only":false,"speaker_num":123,"mode":"speed","callback_url":"\u003cstring>","callback_id":"\u003cstring>","output_uploads":{},"enable_caption":false,"keep_the_same_format":true,"enable_dynamic_duration":true,"disable_music_track":false,"enable_speech_enhancement":false,"enable_watermark":false,"start_time":123,"end_time":123,"brand_voice_id":"\u003cstring>","brand_glossary_id":"\u003cstring>","stock_voice_config":{"use_stock_voice":false,"preferred_stock_voice_ids":["\u003cstring>"]},"srt":{"type":"url","url":"\u003cstring>"},"folder_id":"\u003cstring>"}],"title":"\u003cstring>","callback_url":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ec816bdc-ceca-47a0-a6e8-1da4e3415744":{"description":"Accepted — submission acknowledged; poll for completion.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"properties":{"batch_id":{"description":"Identifier of the created batch. Poll GET /v3/video-translations/batches/{batch_id} for progress.","title":"Batch Id","type":"string","isRequired":true,"uniqueKey":"data.batch_id","typeLabel":"string"}},"required":["batch_id"],"title":"CreateVideoTranslationBatchResponse","type":"object","uniqueKey":"data","typeLabel":"CreateVideoTranslationBatchResponse · object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"batch_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"da0d40d7-3995-4701-8449-554825f138a8":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Video not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"errors":{"type":"array","description":"Per-item error details for batch/multi-node failures (e.g. graph compilation errors by node).","items":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"unknown_node_type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Unknown node type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"},"node_id":{"type":"string","description":"Graph node id this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].node_id","typeLabel":"string"},"port":{"type":"string","description":"Port name on the node this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].port","typeLabel":"string"},"path":{"type":"string","description":"Field path within the item this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Request identifier, also returned in the X-HeyGen-Request-Id response header. Include it when contacting support.","example":"8c4f0b9e1d2a4f6b9e3c7a1d5f2b8e40","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"invalid_parameter","message":"Invalid payload(s) at index 3.","param":"video_translations","doc_url":null}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_parameter","message":"Invalid payload(s) at index 3.","param":"video_translations","doc_url":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"7f41396b-b89a-41dc-a971-8a9f4ab9485d":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Video not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"errors":{"type":"array","description":"Per-item error details for batch/multi-node failures (e.g. graph compilation errors by node).","items":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"unknown_node_type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Unknown node type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"},"node_id":{"type":"string","description":"Graph node id this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].node_id","typeLabel":"string"},"port":{"type":"string","description":"Port name on the node this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].port","typeLabel":"string"},"path":{"type":"string","description":"Field path within the item this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Request identifier, also returned in the X-HeyGen-Request-Id response header. Include it when contacting support.","example":"8c4f0b9e1d2a4f6b9e3c7a1d5f2b8e40","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"unauthorized","message":"Invalid or expired API key. Verify your x-api-key header.","param":null,"doc_url":null}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthorized","message":"Invalid or expired API key. Verify your x-api-key header.","param":null,"doc_url":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"caf649ad-a94b-4942-89e7-65e17e711ca1":{"description":"A prior request with this Idempotency-Key is still in progress. Wait for the original request to complete, then retry.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Video not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"errors":{"type":"array","description":"Per-item error details for batch/multi-node failures (e.g. graph compilation errors by node).","items":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"unknown_node_type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Unknown node type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"},"node_id":{"type":"string","description":"Graph node id this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].node_id","typeLabel":"string"},"port":{"type":"string","description":"Port name on the node this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].port","typeLabel":"string"},"path":{"type":"string","description":"Field path within the item this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Request identifier, also returned in the X-HeyGen-Request-Id response header. Include it when contacting support.","example":"8c4f0b9e1d2a4f6b9e3c7a1d5f2b8e40","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"request_in_progress","message":"A request with this Idempotency-Key is already in progress. Retry shortly.","param":null,"doc_url":null}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"request_in_progress","message":"A request with this Idempotency-Key is already in progress. Retry shortly.","param":null,"doc_url":null}}}},"exampleType":"examples"}},"exampleType":"examples"},"e3096d9e-a3ea-4aaf-b486-acf995b56c12":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"invalid_parameter","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Video not found","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"param":{"oneOf":[{"type":"string","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.0","typeLabel":"string"},{"type":"null","description":"Which request field caused the error","uniqueKey":"error.param.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.param","typeLabel":"string | null"},"doc_url":{"oneOf":[{"type":"string","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Link to error documentation","uniqueKey":"error.doc_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.doc_url","typeLabel":"string | null"},"errors":{"type":"array","description":"Per-item error details for batch/multi-node failures (e.g. graph compilation errors by node).","items":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code","example":"unknown_node_type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","example":"Unknown node type","isRequired":true,"uniqueKey":"error.errors.items.[INDEX].message","typeLabel":"string"},"node_id":{"type":"string","description":"Graph node id this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].node_id","typeLabel":"string"},"port":{"type":"string","description":"Port name on the node this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].port","typeLabel":"string"},"path":{"type":"string","description":"Field path within the item this error pertains to, if applicable","uniqueKey":"error.errors.items.[INDEX].path","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error.errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.errors","typeLabel":"object[]"},"request_id":{"type":"string","description":"Request identifier, also returned in the X-HeyGen-Request-Id response header. Include it when contacting support.","example":"8c4f0b9e1d2a4f6b9e3c7a1d5f2b8e40","uniqueKey":"error.request_id","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Retry after the duration specified in the Retry-After header.","param":null,"doc_url":null}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limit_exceeded","message":"Too many requests. Retry after the duration specified in the Retry-After header.","param":null,"doc_url":null}}}},"exampleType":"examples"}},"headers":{"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer"}}},"exampleType":"examples"}},"security":{"273e43b5-5c2f-49ed-94ee-1f82159e49b3":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"HeyGen API key. Obtain from your HeyGen dashboard.","scopes":[],"schemeName":"ApiKeyAuth"}},"1eaff886-a094-4f6b-8b35-b21c65432411":{"BearerAuth":{"type":"http","scheme":"bearer","description":"OAuth2 bearer token.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"e6cd17e6-82b7-4d18-b2e2-af0f350698c3":{"url":"https://api.heygen.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"HeyGen API key. Obtain from your HeyGen dashboard.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"HeyGen API key. Obtain from your HeyGen dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"OAuth2 bearer token.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth2 bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi/external-api.json"},"subdomain":"heygen-1fa696a7","siteName":"HeyGen Documentation","title":"Create Video Translation Batch - HeyGen Documentation","relatedPagesConfig":{"enabled":true,"limit":8,"mode":"manual"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T00:46:31.787Z","originalFileLocation":"reference/create-video-translation-batch.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HeyGen Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Video Translation Batch - HeyGen Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HeyGen Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://heygen-1fa696a7.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Create+Video+Translation+Batch\u0026amp;description=Submits+up+to+100+translation+payloads%2C+each+shaped+like+POST+%2Fv3%2Fvideo-translations%2C+as+one+batch.+A+payload+with+several+%60output_languages%60+becomes+one+item+p\u0026amp;theme=806bfcae4fd50c26d3779ac8\u0026amp;signature=eb3b8762fc09a192a571a762804f59a2cb2d04517bc7b6b6ff4baf501a0cacc7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Video Translation Batch - HeyGen Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://heygen-1fa696a7.mintlify.site/_mintlify/api/og/v2?division=Batches\u0026amp;title=Create+Video+Translation+Batch\u0026amp;description=Submits+up+to+100+translation+payloads%2C+each+shaped+like+POST+%2Fv3%2Fvideo-translations%2C+as+one+batch.+A+payload+with+several+%60output_languages%60+becomes+one+item+p\u0026amp;theme=806bfcae4fd50c26d3779ac8\u0026amp;signature=eb3b8762fc09a192a571a762804f59a2cb2d04517bc7b6b6ff4baf501a0cacc7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/heygen-1fa696a7/V7Z_LW-WQjtKUYWA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HeyGen Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#03C3FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/create-video-translation-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://heygen-1fa696a7.mintlify.app/#organization\",\"name\":\"HeyGen Documentation\",\"url\":\"https://heygen-1fa696a7.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/heygen-1fa696a7/dQ_uLJDftFYFhC7B/logo/light.png?fit=max\u0026auto=format\u0026n=dQ_uLJDftFYFhC7B\u0026q=85\u0026s=b03d2e41dde1cc0b50cd50e574f66f1c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://heygen-1fa696a7.mintlify.app#website\",\"name\":\"HeyGen Documentation\",\"url\":\"https://heygen-1fa696a7.mintlify.app\",\"publisher\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch#webpage\",\"url\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch\",\"name\":\"Create Video Translation Batch\",\"description\":\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.\",\"dateModified\":\"2026-11-22T00:46:31.787Z\",\"isPartOf\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Batches\",\"item\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-batch\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Video Translation Batch\",\"item\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch#apireference\",\"headline\":\"Create Video Translation Batch\",\"name\":\"Create Video Translation Batch\",\"description\":\"Submits up to 100 translation payloads, each shaped like POST /v3/video-translations, as one batch. A payload with several output_languages becomes one item per language, and items run independently. Returns 202 with a batch_id to poll. Send an Idempotency-Key to make retries safe.\",\"url\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch\",\"mainEntityOfPage\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app/reference/create-video-translation-batch#webpage\"},\"dateModified\":\"2026-11-22T00:46:31.787Z\",\"publisher\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://heygen-1fa696a7.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HeyGen Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"HeyGen Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/create-video-translation-batch.md","siteName":"HeyGen Documentation","nav":{"global":null,"tabs":[{"tab":"Developer Guide","pages":[{"title":"Developer Guide","href":"/docs/quick-start"}]},{"tab":"API Reference","groups":[{"group":"Video","pages":[{"title":"List Videos","deprecated":null,"version":null,"sidebarTitle":"List videos","openapi":"/openapi/external-api.json get /v3/videos","href":"/reference/list-videos"},{"title":"Create Video","deprecated":null,"version":null,"sidebarTitle":"Create video","openapi":"/openapi/external-api.json post /v3/videos","href":"/reference/create-video"},{"title":"Get Video Voice Capabilities","deprecated":null,"version":null,"sidebarTitle":"Get video voice capabilities","openapi":"/openapi/external-api.json get /v3/videos/voice-capabilities","href":"/reference/get-video-voice-capabilities"},{"title":"Get Video","deprecated":null,"version":null,"sidebarTitle":"Get video","openapi":"/openapi/external-api.json get /v3/videos/{video_id}","href":"/reference/get-video"},{"title":"Delete Video","deprecated":null,"version":null,"sidebarTitle":"Delete video","openapi":"/openapi/external-api.json delete /v3/videos/{video_id}","href":"/reference/delete-video"},{"title":"Get Video Scenes","deprecated":null,"version":null,"sidebarTitle":"Get video scenes","openapi":"/openapi/external-api.json get /v3/videos/{video_id}/scenes","href":"/reference/get-video-scenes"},{"title":"Create HeyGen Video","deprecated":null,"version":null,"sidebarTitle":"Create heygen video","openapi":"/openapi/external-api.json post /v3/models/videos","href":"/reference/create-heygen-video"},{"title":"Get HeyGen Video","deprecated":null,"version":null,"sidebarTitle":"Get heygen video","openapi":"/openapi/external-api.json get /v3/models/videos/{video_id}","href":"/reference/get-heygen-video"}]},{"group":"Avatar","pages":[{"title":"List Avatar Groups","deprecated":null,"version":null,"sidebarTitle":"List avatar groups","openapi":"/openapi/external-api.json get /v3/avatars","href":"/reference/list-avatar-groups"},{"title":"Create Avatar","deprecated":null,"version":null,"sidebarTitle":"Create avatar","openapi":"/openapi/external-api.json post /v3/avatars","href":"/reference/create-avatar"},{"title":"Get Avatar Group","deprecated":null,"version":null,"sidebarTitle":"Get avatar group","openapi":"/openapi/external-api.json get /v3/avatars/{group_id}","href":"/reference/get-avatar-group"},{"title":"Delete Avatar Group","deprecated":null,"version":null,"sidebarTitle":"Delete avatar group","openapi":"/openapi/external-api.json delete /v3/avatars/{group_id}","href":"/reference/delete-avatar-group"},{"title":"Update Avatar Group","deprecated":null,"version":null,"sidebarTitle":"Update avatar group","openapi":"/openapi/external-api.json patch /v3/avatars/{group_id}","href":"/reference/update-avatar-group"},{"title":"Create Avatar Consent","deprecated":null,"version":null,"sidebarTitle":"Create avatar consent","openapi":"/openapi/external-api.json post /v3/avatars/{group_id}/consent","href":"/reference/create-avatar-consent"},{"title":"List Avatar Looks","deprecated":null,"version":null,"sidebarTitle":"List avatar looks","openapi":"/openapi/external-api.json get /v3/avatars/looks","href":"/reference/list-avatar-looks"},{"title":"Create Avatar Looks","deprecated":null,"version":null,"sidebarTitle":"Create avatar looks","openapi":"/openapi/external-api.json post /v3/avatars/looks","href":"/reference/create-avatar-looks"},{"title":"List Look Templates","deprecated":null,"version":null,"sidebarTitle":"List look templates","openapi":"/openapi/external-api.json get /v3/avatars/look-templates","href":"/reference/list-look-templates"},{"title":"Get Avatar Look","deprecated":null,"version":null,"sidebarTitle":"Get avatar look","openapi":"/openapi/external-api.json get /v3/avatars/looks/{look_id}","href":"/reference/get-avatar-look"},{"title":"Delete Avatar Look","deprecated":null,"version":null,"sidebarTitle":"Delete avatar look","openapi":"/openapi/external-api.json delete /v3/avatars/looks/{look_id}","href":"/reference/delete-avatar-look"},{"title":"Update Avatar Look","deprecated":null,"version":null,"sidebarTitle":"Update avatar look","openapi":"/openapi/external-api.json patch /v3/avatars/looks/{look_id}","href":"/reference/update-avatar-look"},{"title":"Create Avatar 6 Video","deprecated":null,"version":null,"sidebarTitle":"Create avatar 6 video","openapi":"/openapi/external-api.json post /v3/models/avatars","href":"/reference/create-avatar-6-video"}]},{"group":"Voice","pages":[{"title":"List Audio Voices","deprecated":null,"version":null,"sidebarTitle":"List audio voices","openapi":"/openapi/external-api.json get /v3/models/audio/voices","href":"/reference/list-audio-voices"},{"title":"Create or Retrain an Audio Voice","deprecated":null,"version":null,"sidebarTitle":"Create or retrain an audio voice","openapi":"/openapi/external-api.json post /v3/models/audio/voices","href":"/reference/create-or-retrain-an-audio-voice"},{"title":"Convert Speech","deprecated":null,"version":null,"sidebarTitle":"Convert model speech","openapi":"/openapi/external-api.json post /v3/models/audio/sts","href":"/reference/convert-model-speech"},{"title":"Generate Speech","deprecated":null,"version":null,"sidebarTitle":"Generate model speech","openapi":"/openapi/external-api.json post /v3/models/audio/tts","href":"/reference/generate-model-speech"},{"title":"Stream Speech","deprecated":null,"version":null,"sidebarTitle":"Stream speech","openapi":"/openapi/external-api.json post /v3/models/audio/tts/stream","href":"/reference/stream-speech"},{"title":"Create Speech Input Token","deprecated":null,"version":null,"sidebarTitle":"Create speech input token","openapi":"/openapi/external-api.json post /v3/models/audio/tts/stream-input/tokens","href":"/reference/create-speech-input-token"},{"title":"Get an Audio Voice","deprecated":null,"version":null,"sidebarTitle":"Get an audio voice","openapi":"/openapi/external-api.json get /v3/models/audio/voices/{voice_id}","href":"/reference/get-an-audio-voice"},{"title":"Delete an Audio Voice","deprecated":null,"version":null,"sidebarTitle":"Delete an audio voice","openapi":"/openapi/external-api.json delete /v3/models/audio/voices/{voice_id}","href":"/reference/delete-an-audio-voice"}]},{"group":"Audio","pages":[{"title":"Search audio (music or sound effects)","deprecated":null,"version":null,"sidebarTitle":"Search audio music or sound effects","openapi":"/openapi/external-api.json get /v3/audio/sounds","href":"/reference/search-audio-music-or-sound-effects"}]},{"group":"Image","pages":[{"title":"Create HeyGen Image","deprecated":null,"version":null,"sidebarTitle":"Create heygen image","openapi":"/openapi/external-api.json post /v3/models/images","href":"/reference/create-heygen-image"},{"title":"Get HeyGen Image","deprecated":null,"version":null,"sidebarTitle":"Get heygen image","openapi":"/openapi/external-api.json get /v3/models/images/{generation_id}","href":"/reference/get-heygen-image"}]},{"group":"Video editing","pages":[{"title":"List Video Translations","deprecated":null,"version":null,"sidebarTitle":"List video translations","openapi":"/openapi/external-api.json get /v3/video-translations","href":"/reference/list-video-translations"},{"title":"Create Video Translation","deprecated":null,"version":null,"sidebarTitle":"Create video translation","openapi":"/openapi/external-api.json post /v3/video-translations","href":"/reference/create-video-translation"},{"title":"Get Video Translation","deprecated":null,"version":null,"sidebarTitle":"Get video translation","openapi":"/openapi/external-api.json get /v3/video-translations/{video_translation_id}","href":"/reference/get-video-translation"},{"title":"Delete Video Translation","deprecated":null,"version":null,"sidebarTitle":"Delete video translation","openapi":"/openapi/external-api.json delete /v3/video-translations/{video_translation_id}","href":"/reference/delete-video-translation"},{"title":"Update Video Translation","deprecated":null,"version":null,"sidebarTitle":"Update video translation","openapi":"/openapi/external-api.json patch /v3/video-translations/{video_translation_id}","href":"/reference/update-video-translation"},{"title":"List Supported Translation Languages","deprecated":null,"version":null,"sidebarTitle":"List supported translation languages","openapi":"/openapi/external-api.json get /v3/video-translations/languages","href":"/reference/list-supported-translation-languages"},{"title":"List Proofread Sessions","deprecated":null,"version":null,"sidebarTitle":"List proofread sessions","openapi":"/openapi/external-api.json get /v3/video-translations/proofreads","href":"/reference/list-proofread-sessions"},{"title":"Create Proofread Session","deprecated":null,"version":null,"sidebarTitle":"Create proofread session","openapi":"/openapi/external-api.json post /v3/video-translations/proofreads","href":"/reference/create-proofread-session"},{"title":"Get Proofread Session","deprecated":null,"version":null,"sidebarTitle":"Get proofread session","openapi":"/openapi/external-api.json get /v3/video-translations/proofreads/{proofread_id}","href":"/reference/get-proofread-session"},{"title":"Delete Proofread Session","deprecated":null,"version":null,"sidebarTitle":"Delete proofread session","openapi":"/openapi/external-api.json delete /v3/video-translations/proofreads/{proofread_id}","href":"/reference/delete-proofread-session"},{"title":"Download Proofread SRT","deprecated":null,"version":null,"sidebarTitle":"Download proofread srt","openapi":"/openapi/external-api.json get /v3/video-translations/proofreads/{proofread_id}/srt","href":"/reference/download-proofread-srt"},{"title":"Upload Proofread SRT","deprecated":null,"version":null,"sidebarTitle":"Upload proofread srt","openapi":"/openapi/external-api.json put /v3/video-translations/proofreads/{proofread_id}/srt","href":"/reference/upload-proofread-srt"},{"title":"Generate Video from Proofread","deprecated":null,"version":null,"sidebarTitle":"Generate video from proofread","openapi":"/openapi/external-api.json post /v3/video-translations/proofreads/{proofread_id}/generate","href":"/reference/generate-video-from-proofread"},{"title":"List Lipsyncs","deprecated":null,"version":null,"sidebarTitle":"List lipsyncs","openapi":"/openapi/external-api.json get /v3/lipsyncs","href":"/reference/list-lipsyncs"},{"title":"Create Lipsync","deprecated":null,"version":null,"sidebarTitle":"Create lipsync","openapi":"/openapi/external-api.json post /v3/lipsyncs","href":"/reference/create-lipsync"},{"title":"Get Lipsync","deprecated":null,"version":null,"sidebarTitle":"Get lipsync","openapi":"/openapi/external-api.json get /v3/lipsyncs/{lipsync_id}","href":"/reference/get-lipsync"},{"title":"Delete Lipsync","deprecated":null,"version":null,"sidebarTitle":"Delete lipsync","openapi":"/openapi/external-api.json delete /v3/lipsyncs/{lipsync_id}","href":"/reference/delete-lipsync"},{"title":"Update Lipsync","deprecated":null,"version":null,"sidebarTitle":"Update lipsync","openapi":"/openapi/external-api.json patch /v3/lipsyncs/{lipsync_id}","href":"/reference/update-lipsync"},{"title":"Get AI Clipping","deprecated":null,"version":null,"sidebarTitle":"Get ai clipping","openapi":"/openapi/external-api.json get /v3/ai-clipping/{job_id}","href":"/reference/get-ai-clipping"},{"title":"Delete AI Clipping","deprecated":null,"version":null,"sidebarTitle":"Delete ai clipping","openapi":"/openapi/external-api.json delete /v3/ai-clipping/{job_id}","href":"/reference/delete-ai-clipping"},{"title":"List AI Clipping","deprecated":null,"version":null,"sidebarTitle":"List ai clipping","openapi":"/openapi/external-api.json get /v3/ai-clipping","href":"/reference/list-ai-clipping"},{"title":"Create AI Clipping","deprecated":null,"version":null,"sidebarTitle":"Create ai clipping","openapi":"/openapi/external-api.json post /v3/ai-clipping","href":"/reference/create-ai-clipping"},{"title":"Create Filler Word Removal","deprecated":null,"version":null,"sidebarTitle":"Create filler word removal","openapi":"/openapi/external-api.json post /v3/filler-word-removals","href":"/reference/create-filler-word-removal"},{"title":"Get Filler Word Removal","deprecated":null,"version":null,"sidebarTitle":"Get filler word removal","openapi":"/openapi/external-api.json get /v3/filler-word-removals/{filler_word_removal_id}","href":"/reference/get-filler-word-removal"}]},{"group":"Video Agent","pages":[{"title":"List Video Agent Sessions","deprecated":null,"version":null,"sidebarTitle":"List video agent sessions","openapi":"/openapi/external-api.json get /v3/video-agents","href":"/reference/list-video-agent-sessions"},{"title":"Create Video Agent Session","deprecated":null,"version":null,"sidebarTitle":"Create video agent session","openapi":"/openapi/external-api.json post /v3/video-agents","href":"/reference/create-video-agent-session"},{"title":"List Video Agent Styles","deprecated":null,"version":null,"sidebarTitle":"List video agent styles","openapi":"/openapi/external-api.json get /v3/video-agents/styles","href":"/reference/list-video-agent-styles"},{"title":"Get Video Agent Session","deprecated":null,"version":null,"sidebarTitle":"Get video agent session","openapi":"/openapi/external-api.json get /v3/video-agents/{session_id}","href":"/reference/get-video-agent-session"},{"title":"Send Video Agent Message","deprecated":null,"version":null,"sidebarTitle":"Send message or request revision","openapi":"/openapi/external-api.json post /v3/video-agents/{session_id}","href":"/reference/send-message-or-request-revision"},{"title":"Get Session Resource","deprecated":null,"version":null,"sidebarTitle":"Get session resource","openapi":"/openapi/external-api.json get /v3/video-agents/{session_id}/resources/{resource_id}","href":"/reference/get-session-resource"},{"title":"List Session Videos","deprecated":null,"version":null,"sidebarTitle":"List session videos","openapi":"/openapi/external-api.json get /v3/video-agents/{session_id}/videos","href":"/reference/list-session-videos"},{"title":"Stop Video Agent Session","deprecated":null,"version":null,"sidebarTitle":"Stop video agent session","openapi":"/openapi/external-api.json post /v3/video-agents/{session_id}/stop","href":"/reference/stop-video-agent-session"}]},{"group":"Templates","pages":[{"title":"List Templates","deprecated":null,"version":null,"sidebarTitle":"List templates","openapi":"/openapi/external-api.json get /v3/templates","href":"/reference/list-templates"},{"title":"Create Template from Video","deprecated":null,"version":null,"sidebarTitle":"Create template from video","openapi":"/openapi/external-api.json post /v3/templates","href":"/reference/create-template-from-video"},{"title":"Get Template","deprecated":null,"version":null,"sidebarTitle":"Get template","openapi":"/openapi/external-api.json get /v3/templates/{template_id}","href":"/reference/get-template"},{"title":"Generate Video from Template","deprecated":null,"version":null,"sidebarTitle":"Generate video from template","openapi":"/openapi/external-api.json post /v3/templates/{template_id}","href":"/reference/generate-video-from-template"},{"title":"Delete Template","deprecated":null,"version":null,"sidebarTitle":"Delete template","openapi":"/openapi/external-api.json delete /v3/templates/{template_id}","href":"/reference/delete-template"},{"title":"Update Template","deprecated":null,"version":null,"sidebarTitle":"Update template","openapi":"/openapi/external-api.json patch /v3/templates/{template_id}","href":"/reference/update-template"},{"title":"Set Template Variables","deprecated":null,"version":null,"sidebarTitle":"Set template variables","openapi":"/openapi/external-api.json put /v3/templates/{template_id}/variables","href":"/reference/set-template-variables"}]},{"group":"HyperFrames","pages":[{"title":"List HyperFrames Renders","deprecated":null,"version":null,"sidebarTitle":"List hyperframes renders","openapi":"/openapi/external-api.json get /v3/hyperframes/renders","href":"/reference/list-hyperframes-renders"},{"title":"Create HyperFrames Render","deprecated":null,"version":null,"sidebarTitle":"Create hyperframes render","openapi":"/openapi/external-api.json post /v3/hyperframes/renders","href":"/reference/create-hyperframes-render"},{"title":"Get HyperFrames Render","deprecated":null,"version":null,"sidebarTitle":"Get hyperframes render","openapi":"/openapi/external-api.json get /v3/hyperframes/renders/{render_id}","href":"/reference/get-hyperframes-render"},{"title":"Delete HyperFrames Render","deprecated":null,"version":null,"sidebarTitle":"Delete hyperframes render","openapi":"/openapi/external-api.json delete /v3/hyperframes/renders/{render_id}","href":"/reference/delete-hyperframes-render"}]},{"group":"Brand","pages":[{"title":"List Brand Glossaries","deprecated":null,"version":null,"sidebarTitle":"List brand glossaries","openapi":"/openapi/external-api.json get /v3/brand-glossaries","href":"/reference/list-brand-glossaries"},{"title":"Create Brand Glossary","deprecated":null,"version":null,"sidebarTitle":"Create brand glossary","openapi":"/openapi/external-api.json post /v3/brand-glossaries","href":"/reference/create-brand-glossary"},{"title":"List Brand Kits","deprecated":null,"version":null,"sidebarTitle":"List brand kits","openapi":"/openapi/external-api.json get /v3/brand-kits","href":"/reference/list-brand-kits"},{"title":"Create Brand Kit","deprecated":null,"version":null,"sidebarTitle":"Create brand kit","openapi":"/openapi/external-api.json post /v3/brand-kits","href":"/reference/create-brand-kit"},{"title":"Get Brand Kit","deprecated":null,"version":null,"sidebarTitle":"Get brand kit","openapi":"/openapi/external-api.json get /v3/brand-kits/{brand_kit_id}","href":"/reference/get-brand-kit"},{"title":"Delete Brand Kit","deprecated":null,"version":null,"sidebarTitle":"Delete brand kit","openapi":"/openapi/external-api.json delete /v3/brand-kits/{brand_kit_id}","href":"/reference/delete-brand-kit"},{"title":"Update Brand Kit","deprecated":null,"version":null,"sidebarTitle":"Update brand kit","openapi":"/openapi/external-api.json patch /v3/brand-kits/{brand_kit_id}","href":"/reference/update-brand-kit"},{"title":"Get Brand Glossary","deprecated":null,"version":null,"sidebarTitle":"Get brand glossary","openapi":"/openapi/external-api.json get /v3/brand-glossaries/{brand_glossary_id}","href":"/reference/get-brand-glossary"},{"title":"Delete Brand Glossary","deprecated":null,"version":null,"sidebarTitle":"Delete brand glossary","openapi":"/openapi/external-api.json delete /v3/brand-glossaries/{brand_glossary_id}","href":"/reference/delete-brand-glossary"},{"title":"Update Brand Glossary","deprecated":null,"version":null,"sidebarTitle":"Update brand glossary","openapi":"/openapi/external-api.json patch /v3/brand-glossaries/{brand_glossary_id}","href":"/reference/update-brand-glossary"}]},{"group":"Assets and folders","pages":[{"title":"Create Folder","deprecated":null,"version":null,"sidebarTitle":"Create folder","openapi":"/openapi/external-api.json post /v3/folders","href":"/reference/create-folder"},{"title":"Get Folder","deprecated":null,"version":null,"sidebarTitle":"Get folder","openapi":"/openapi/external-api.json get /v3/folders/{folder_id}","href":"/reference/get-folder"},{"title":"Upload Asset","deprecated":null,"version":null,"sidebarTitle":"Upload asset","openapi":"/openapi/external-api.json post /v3/assets","href":"/reference/upload-asset"},{"title":"Get Asset","deprecated":null,"version":null,"sidebarTitle":"Get asset","openapi":"/openapi/external-api.json get /v3/assets/{asset_id}","href":"/reference/get-asset"},{"title":"Delete Asset","deprecated":null,"version":null,"sidebarTitle":"Delete asset","openapi":"/openapi/external-api.json delete /v3/assets/{asset_id}","href":"/reference/delete-asset"},{"title":"Create Asset Upload","deprecated":null,"version":null,"sidebarTitle":"Create asset upload","openapi":"/openapi/external-api.json post /v3/assets/direct-uploads","href":"/reference/create-asset-upload"},{"title":"Complete Asset Upload","deprecated":null,"version":null,"sidebarTitle":"Complete asset upload","openapi":"/openapi/external-api.json post /v3/assets/{asset_id}/complete","href":"/reference/complete-asset-upload"},{"title":"List Uploaded Asset Parts","deprecated":null,"version":null,"sidebarTitle":"List uploaded asset parts","openapi":"/openapi/external-api.json get /v3/assets/{asset_id}/parts","href":"/reference/list-uploaded-asset-parts"},{"title":"Get Asset Upload Part URLs","deprecated":null,"version":null,"sidebarTitle":"Get asset upload part urls","openapi":"/openapi/external-api.json post /v3/assets/{asset_id}/parts","href":"/reference/get-asset-upload-part-urls"},{"title":"Abort Asset Upload Parts","deprecated":null,"version":null,"sidebarTitle":"Abort asset upload parts","openapi":"/openapi/external-api.json delete /v3/assets/{asset_id}/parts","href":"/reference/abort-asset-upload-parts"}]},{"group":"Batches","pages":[{"title":"Create Video Batch","deprecated":null,"version":null,"sidebarTitle":"Create video batch","openapi":"/openapi/external-api.json post /v3/videos/batches","href":"/reference/create-video-batch"},{"title":"Get Video Batch","deprecated":null,"version":null,"sidebarTitle":"Get video batch","openapi":"/openapi/external-api.json get /v3/videos/batches/{batch_id}","href":"/reference/get-video-batch"},{"title":"Bulk Video Statuses","description":"Returns statuses for up to 100 videos in one request, addressed by comma-separated video_ids and/or batch_ids query params. Statuses are one of queued, processing, completed, or failed, plus not_found for unknown or unowned ids.","deprecated":null,"version":null,"sidebarTitle":"Bulk video statuses","openapi":"/openapi/external-api.json get /v3/videos/statuses","href":"/reference/bulk-video-statuses"},{"title":"Create Video Translation Batch","deprecated":null,"version":null,"sidebarTitle":"Create video translation batch","openapi":"/openapi/external-api.json post /v3/video-translations/batches","href":"/reference/create-video-translation-batch"},{"title":"Get Video Translation Batch","description":"Returns batch aggregate status and one page of items with their ids and statuses. Item statuses are one of queued, processing, completed, or failed. The per-item id is returned as video_id (the batch read model is shared with the videos batch API).","deprecated":null,"version":null,"sidebarTitle":"Get video translation batch","openapi":"/openapi/external-api.json get /v3/video-translations/batches/{batch_id}","href":"/reference/get-video-translation-batch"},{"title":"Bulk Video Translation Statuses","deprecated":null,"version":null,"sidebarTitle":"Bulk video translation statuses","openapi":"/openapi/external-api.json get /v3/video-translations/statuses","href":"/reference/bulk-video-translation-statuses"},{"title":"Create Lipsync Batch","deprecated":null,"version":null,"sidebarTitle":"Create lipsync batch","openapi":"/openapi/external-api.json post /v3/lipsyncs/batches","href":"/reference/create-lipsync-batch"},{"title":"Get Lipsync Batch","deprecated":null,"version":null,"sidebarTitle":"Get lipsync batch","openapi":"/openapi/external-api.json get /v3/lipsyncs/batches/{batch_id}","href":"/reference/get-lipsync-batch"},{"title":"Bulk Lipsync Statuses","deprecated":null,"version":null,"sidebarTitle":"Bulk lipsync statuses","openapi":"/openapi/external-api.json get /v3/lipsyncs/statuses","href":"/reference/bulk-lipsync-statuses"},{"title":"Create Asset Upload Batch","deprecated":null,"version":null,"sidebarTitle":"Create asset upload batch","openapi":"/openapi/external-api.json post /v3/assets/direct-uploads/batches","href":"/reference/create-asset-upload-batch"},{"title":"Complete Asset Upload Batch","deprecated":null,"version":null,"sidebarTitle":"Complete asset upload batch","openapi":"/openapi/external-api.json post /v3/assets/complete/batches","href":"/reference/complete-asset-upload-batch"},{"title":"Get Asset Batch","deprecated":null,"version":null,"sidebarTitle":"Get asset batch","openapi":"/openapi/external-api.json get /v3/assets/batches/{batch_id}","href":"/reference/get-asset-batch"},{"title":"Bulk Asset Statuses","deprecated":null,"version":null,"sidebarTitle":"Bulk asset statuses","openapi":"/openapi/external-api.json get /v3/assets/statuses","href":"/reference/bulk-asset-statuses"}]},{"group":"Webhooks","pages":[{"title":"List Webhook Event Types","deprecated":null,"version":null,"sidebarTitle":"List webhook event types","openapi":"/openapi/external-api.json get /v3/webhooks/event-types","href":"/reference/list-webhook-event-types"},{"title":"List Webhook Endpoints","deprecated":null,"version":null,"sidebarTitle":"List webhook endpoints","openapi":"/openapi/external-api.json get /v3/webhooks/endpoints","href":"/reference/list-webhook-endpoints"},{"title":"Create Webhook Endpoint","deprecated":null,"version":null,"sidebarTitle":"Create webhook endpoint","openapi":"/openapi/external-api.json post /v3/webhooks/endpoints","href":"/reference/create-webhook-endpoint"},{"title":"Delete Webhook Endpoint","deprecated":null,"version":null,"sidebarTitle":"Delete webhook endpoint","openapi":"/openapi/external-api.json delete /v3/webhooks/endpoints/{endpoint_id}","href":"/reference/delete-webhook-endpoint"},{"title":"Update Webhook Endpoint","deprecated":null,"version":null,"sidebarTitle":"Update webhook endpoint","openapi":"/openapi/external-api.json patch /v3/webhooks/endpoints/{endpoint_id}","href":"/reference/update-webhook-endpoint"},{"title":"Rotate Webhook Signing Secret","deprecated":null,"version":null,"sidebarTitle":"Rotate webhook signing secret","openapi":"/openapi/external-api.json post /v3/webhooks/endpoints/{endpoint_id}/rotate-secret","href":"/reference/rotate-webhook-signing-secret"},{"title":"List Webhook Events","deprecated":null,"version":null,"sidebarTitle":"List webhook events","openapi":"/openapi/external-api.json get /v3/webhooks/events","href":"/reference/list-webhook-events"}]},{"group":"Feedback","pages":[{"title":"Send Feedback","deprecated":null,"version":null,"sidebarTitle":"Send feedback","openapi":"/openapi/external-api.json post /v3/feedback","href":"/reference/send-feedback"}]},{"group":"Account and usage","pages":[{"title":"Get Current User","deprecated":null,"version":null,"sidebarTitle":"Get current user","openapi":"/openapi/external-api.json get /v3/users/me","href":"/reference/get-current-user"},{"title":"Get Current API Key","deprecated":null,"version":null,"sidebarTitle":"Get current api key","openapi":"/openapi/external-api.json get /v3/api_keys/self","href":"/reference/get-current-api-key"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"Skills","pages":[{"title":"Skills","href":"/skills/overview"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Get help","pages":[{"title":"Get help","href":"/docs/discord"}]}]},"basePath":"","title":"Create Video Translation Batch - HeyGen Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","Page-CVJ-f_k1.js","CodeSnippet-D_HwgQO_.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","getApiPlaygroundDisplay-CmCoerhe.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}