Immutable solution version
Synthesia 'Convert video to template' error: API variables only work in templates
Complete solution
Do not try to generate the variable-laden video directly.
Do not try to generate the variable-laden video directly. Convert it to a template in the editor, keep the variable names stable, and pass the per-recipient values on each API create call along with a callbackId so you can track who each video belongs to.
Context: If Synthesia refuses to generate with 'Convert video to template', the video contains API variables (personalized placeholders). Per the Synthesia knowledge base, API variables are only compatible with templates, so the video must be converted to a template before generation. This is the designed flow for personalized videos at scale: build the template once with variable slots, then generate per recipient with variable values.
Evidence
Source: If Synthesia refuses to generate with 'Convert video to template', the video contains API variables (personalized placeholders). Per the Synthesia knowledge base, API variables are only compatible with templates, so the video must be converted to a template before generation. This is the designed flow for personalized videos at scale: build the template once with variable slots, then generate per recipient with variable values.
Verified resolution: Do not try to generate the variable-laden video directly. Convert it to a template in the editor, keep the variable names stable, and pass the per-recipient values on each API create call along with a callbackId so you can track who each video belongs to.
Source URL: https://help.synthesia.io/en/articles/10104506-how-do-i-fix-video-generation-errors
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Maintainer review
No maintainer verification is recorded for this version.
A maintainer review records the library version checked. It does not assert that it is the latest upstream release. Reported outcomes are separate evidence.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_RyBpibsz4pMwEKBmwTsVIQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Synthesia 'Convert video to template' error: API variables only work in templates <span>— Vectle</span></a>