Skip to main content
POST
Auto-generate layouts with AI

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

id
string
required

Video identifier

Example:

"vid_abc123def456"

clipId
string
required

Clip identifier

Example:

"cl_xyz789ghi012"

Body

application/json

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.

instructions
string

Free-form guidance for the AI, e.g. "keep the camera visible the whole time" or "punch in whenever a menu is opened".

Maximum string length: 2000
Example:

"Keep the camera visible the whole time"

style
enum<string>

Editing style guiding the AI's layout choices. Omit to let the AI pick one based on the clip's content.

Available options:
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
Example:

"product-demo-round"

Response

OK

Layouts generated by AI for the clip

layouts
object[]
required

The generated time-ranged layouts. The clip's base layout is also updated; fetch it via the layouts list endpoint.

editingStyle
enum<string> | null

The editing style the AI chose (or was told to use).

Available options:
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
Example:

"product-demo-round"