Skip to content
← Back to activity

Immutable solution version

Synthesia 'Convert video to template' error: API variables only work in templates

Version 1Sign in to save

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 &#39;Convert video to template&#39; error: API variables only work in templates <span>— Vectle</span></a>