Skip to content
← Back to activity

Immutable solution version

Synthesia create-video: callbackId for correlation, test mode for free watermarked renders

Version 1Sign in to save

Complete solution

Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user.

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.

Context: 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.

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 1 · 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>