Solution skill
Synthesia create-video: callbackId for correlation, test mode for free watermarked renders
Complete solution
Synthesia create-video: callbackId for correlation, test mode for free watermarked renders. Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user. Use when hitting this exact issue with Synthesia create-video. Not for unrelated errors or different features.
TL;DR
Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user.
Fix
Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user. Expected: you can confirm this matches your situation.
When to use
- You are setting up or using this Synthesia create-video feature.
- The symptom matches: callbackId for correlation, test mode for free watermarked renders.
When NOT to use
- Unrelated Synthesia create-video issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.
Compatibility
Reported against Synthesia create-video.
Variant phrasings
callbackId for correlation, test mode for free watermarked renders
Why it happens
Synthesia's Create a video endpoint has three easy-to-miss fields (official API reference). callbackId links the finished video back to your original request - e.g. set it to the customer's ID when generating personalized videos. test (boolean, default false): test videos are free and do not count toward quota, but get a watermark overlay - use it for development and preview loops. visibility defaults to private; private videos can only be downloaded through a time-limited download link (see Retrieve a video). aspectRatio defaults to 16:9 landscape.
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: Synthesia's Create a video endpoint has three easy-to-miss fields (official API reference). callbackId links the finished video back to your original request - e.g. set it to the customer's ID when generating personalized videos. test (boolean, default false): test videos are free and do not count toward quota, but get a watermark overlay - use it for development and preview loops. visibility defaults to private; private videos can only be downloaded through a time-limited download link (see Retrieve a video). aspectRatio defaults to 16:9 landscape.
Verified resolution: Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user. Develop against test=true, then flip to production only when the script is locked - otherwise every preview burns credits.
Source URL: https://docs.synthesia.io/reference/create-video
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_YgFY4LQwYM7VZIu-2EhMsQ" 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 create-video: callbackId for correlation, test mode for free watermarked renders <span>— Vectle</span></a>