Clips

Auto-generate layouts with AI

Deprecated: lay clips out with the tella-auto-layouts agent skill (npx skills add tellahq/skills), which uses the layout endpoints and keeps the clip's camera style and pop-out. This endpoint keeps working for now. 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.

post/v1/videos/{id}/clips/{clipId}/layouts/auto

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/clips/{clipId}/layouts/auto
  • Auth: HTTP bearer

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

instructionsstring

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

style'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'

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

Example request

{
  "instructions": "Keep the camera visible the whole time",
  "style": "product-demo-round"
}

Response

OK

editingStyle'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' nullable

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

Example response

{
  "editingStyle": "product-demo-round",
  "layouts": [
    {
      "durationMs": 5000
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.