Auto-generate layouts with AI
Lets AI watch the clip and lay it out — the API twin of the editor’s “Auto layouts”. The clip’s existing layouts are replaced: the AI picks an editing style (or follows style), sets the clip’s base layout, and adds time-ranged layout changes. Generation watches the actual video, so expect the request to take on the order of a minute for longer clips.
Authorizations
API key obtained from your Tella account settings
Path Parameters
Video identifier
"vid_abc123def456"
Clip identifier
"cl_xyz789ghi012"
Body
Let AI watch the clip and lay it out — the API twin of the editor's "Auto layouts". Replaces the clip's existing layouts with the generated ones.
Free-form guidance for the AI, e.g. "keep the camera visible the whole time" or "punch in whenever a menu is opened".
2000"Keep the camera visible the whole time"
Editing style guiding the AI's layout choices. Omit to let the AI pick one based on the clip's content.
product-demo-portrait, product-demo-round, product-demo-square, product-demo-wide, presentation-tv-show, presentation-portrait, tutorial-round, tutorial-square, intro, outro, intro-and-outro "product-demo-round"
Response
OK
Layouts generated by AI for the clip
The generated time-ranged layouts. The clip's base layout is also updated; fetch it via the layouts list endpoint.
The editing style the AI chose (or was told to use).
product-demo-portrait, product-demo-round, product-demo-square, product-demo-wide, presentation-tv-show, presentation-portrait, tutorial-round, tutorial-square, intro, outro, intro-and-outro "product-demo-round"