Solution skill
Synthesia API script tags: pause with [break] and fix pronunciation with [sub]
Complete solution
Synthesia API script tags: pause with [break] and fix pronunciation with [sub]. Use the break tag for pacing long sentences instead of padding with punctuation, and the sub tag for brand names and acronyms the default voice mangles. Use when hitting this exact issue with Synthesia API script tags. Not for unrelated errors or different features.
TL;DR
Use the break tag for pacing long sentences instead of padding with punctuation, and the sub tag for brand names and acronyms the default voice mangles. Only these two tags are documented - other SSML tags are not supported, so do not assume full SSML works.
Fix
Use the break tag for pacing long sentences instead of padding with punctuation, and the sub tag for brand names and acronyms the default voice mangles. Expected: You get the expected result; the problem is gone.
When to use
- You are setting up or using this Synthesia API script tags feature.
- The symptom matches: pause with [break] and fix pronunciation with [sub].
When NOT to use
- Unrelated Synthesia API script tags issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.
Compatibility
Reported against Synthesia API script tags. Source: https://docs.synthesia.io/reference/script-supported-xml-tags.
Variant phrasings
pause with [break] and fix pronunciation with [sub]
Why it happens
Synthesia API scripts support a small set of XML-like tags for timing and pronunciation (official docs: Script supported XML tags). The break tag inserts a pause: Hello [break time="2s"/] world. The time attribute takes seconds and it works with all voices. The sub tag controls pronunciation: the alias attribute is what the avatar says, the inner text is what appears in captions. Example: The word is [sub alias="Syn-the-zia"]Synthesia[/sub] - the avatar says 'Syn-the-zia' while captions show 'Synthesia'.
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.
Source
https://docs.synthesia.io/reference/script-supported-xml-tags
Evidence
Source: Synthesia API scripts support a small set of XML-like tags for timing and pronunciation (official docs: Script supported XML tags). The break tag inserts a pause: Hello [break time="2s"/] world. The time attribute takes seconds and it works with all voices. The sub tag controls pronunciation: the alias attribute is what the avatar says, the inner text is what appears in captions. Example: The word is [sub alias="Syn-the-zia"]Synthesia[/sub] - the avatar says 'Syn-the-zia' while captions show 'Synthesia'.
Verified resolution: Use the break tag for pacing long sentences instead of padding with punctuation, and the sub tag for brand names and acronyms the default voice mangles. Only these two tags are documented - other SSML tags are not supported, so do not assume full SSML works.
Source URL: https://docs.synthesia.io/reference/script-supported-xml-tags
By @issueatlas · Version 3 · 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_9vP2h2esbD70Wp9w8LMrow" 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 API script tags: pause with [break] and fix pronunciation with [sub] <span>— Vectle</span></a>