`drawings_ai_placer`

AI agent that reads a transcript and automatically places animated drawing clips (lists, text, logos, diagrams, Remotion compositions) into timeline gaps.

When to use

Use when you want AI to decide which drawing type to create and where to place it, based on what the speaker is saying. For manual placement of specific drawings, use the individual drawing processors directly.

In the editor

Add it from the Library (AI group), or with + add step and a search for drawings_ai_placer, after your transcript step.

Under Inputs, add transcript as a step input. Then set the boundaries you want it to work within: max_generate caps how many overlays it may make, min_gap_sec stops it filling gaps too short to notice, and min_duration_sec with max_duration_sec bound how long each one stays up. level is where they go, brand_palette keeps them in your colors, and safe_zone_bottom_pct reserves space at the bottom of the frame so overlays and captions do not collide. backbone_step is the ID of the step that sets the video's length.

Tick Review gate: this step invents content, and the gate lets you see the overlays before the rest of the run is built on them.

After it runs, the overlays appear as clips on the level you chose, and you can preview, retime or delete them in the run timeline. If you want particular overlays at particular moments instead, place them yourself with the individual drawing steps.

YAML Example

- id: drawings
  processor: drawings_ai_placer
  input:
    - id: transcript
      step: transcribe_main
  params:
    level: broll
    max_generate: 6
    min_gap_sec: 5
    min_duration_sec: 3.0
    max_duration_sec: 8.0
    brand_palette: "1a1a2e,e94560,0f3460"
    backbone_step: ai_cut
    safe_zone_bottom_pct: 20
  output:
    timeline: broll
  review: true
  cache: true

Inputs

ID	Source	Description
`transcript`	step	Word-level timestamps

Params

Param	Type	Default	Description
`level`	level	`"broll"`	Output timeline level
`min_gap_sec`	duration (s)	`3`	Minimum gap size to fill
`max_generate`	number	`6`	Maximum new drawing clips to create
`min_duration_sec`	duration (s)	`2`	Minimum drawing clip duration
`max_duration_sec`	duration (s)	`8`	Maximum drawing clip duration
`background`	string	`"auto"`	`"auto"` or `"solid:#rrggbb"`
`brand_palette`	string	none	Comma-separated hex colors
`padding_pct`	number	`8`	Padding as % of frame
`safe_zone_bottom_pct`	number	`0`	% of bottom frame height to keep clear (for captions)
`backbone_step`	string	none	Step ID to compute total timeline duration
`tools`	list	none	Whitelist of drawing tool names to allow
`exclude_tools`	list	none	Blacklist of drawing tool names to exclude
`content_variants`	number	`1`	When > 1, Claude generates N alternative drawings per slot at the same position. One is randomly enabled; the rest are disabled (greyed out) in FCP so you can swap.

Output

EditDecisions on the configured level.

Notes

Uses Puffin Ship's built-in AI: no API key required.
Available drawing tools: create_list, create_text, create_logos, create_diagram, and Remotion variants.
tools and exclude_tools are mutually exclusive.
Drawings already made for a run are remembered, so re-running the step reuses them instead of regenerating.
Use safe_zone_bottom_pct to avoid placing content where captions will appear.