Create AI Video: Synthesia action

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
Title title	string	Optional	Video title
Script script_text	string	Required	What the avatar should say
Avatar ID avatar	string	Optional	Synthesia avatar id (call list-avatars to find more)
Background background	string	Optional	Background id or color
Voice ID voice	string	Optional	Voice id (auto if blank)
Test Mode test	options	Optional	Test Mode. Options: Yes (free, watermarked), No (charged)

Sample request

{
  "title": "Q3 Update",
  "script_text": "{{trigger.script_text}}",
  "avatar": "e.g. anna_costume1_cameraA, james_costume1_cameraA",
  "background": "off_white, green_screen, custom",
  "voice": "leave empty to use default for avatar"
}

Returns

{
  "id": "vid-abc123",
  "title": "Q3 Update",
  "status": "in_progress",
  "download": null,
  "duration": null,
  "createdAt": 1700000000
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Create AI Video.

What does the Create AI Video action do in Synthesia?

Renders a Synthesia video of an AI avatar reading your script in the chosen voice and background. Generation is asynchronous, so pair this with Get Video to poll until the download URL is ready.

What inputs does Create AI Video require?

Required: Script. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Synthesia returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Create AI Video support batch operations?

Yes. Run Create AI Video inside a Loop node to process arrays. Tiny Command handles Synthesia's rate limits automatically so you don't have to throttle manually.

More actions