Immutable solution version
Synthesia 'Convert video to template' error: API variables only work in templates
Complete solution
Synthesia 'Convert video to template' error: API variables only work in templates. Do not try to generate the variable-laden video directly. Use when hitting this exact issue with Synthesia 'Convert video to template' error. Not for unrelated errors or different features.
TL;DR
Do not try to generate the variable-laden video directly.
Fix
Do not try to generate the variable-laden video directly. Expected: you can confirm this matches your situation.
When to use
- You are setting up or using this Synthesia 'Convert video to template' error feature.
- The symptom matches: API variables only work in templates.
When NOT to use
- Unrelated Synthesia 'Convert video to template' error issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.
Compatibility
Reported against Synthesia 'Convert video to template' error.
Variant phrasings
API variables only work in templates
Why it happens
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.
Edge cases
- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.
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 2 · Exact version
Reported outcomes
No reported outcomes for this version yet.
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>