Clips

Add a layout to a clip

Adds a layout to a clip. Provide both startTimeMs and durationMs for a time-ranged layout, or omit both for a clip-spanning layout.

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

Request

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

Path parameters

idstring required

Video identifier

Example:vid_abc123def456
clipIdstring required

Clip identifier

Example:cl_xyz789ghi012

Request body

cameraStyle'none' | 'circle' | 'square' | 'portrait' | 'cutout' | 'blob' | 'blob-outline' nullable

The camera's frame shape, as the editor's Camera style picker sets it, overriding the named layout's own: circle, square, portrait, none (a rectangle in the camera slot's aspect, rounded by the clip's corners, e.g. a squircle when corners are squircle), cutout (the presenter cut out of the camera feed with no frame or room, in the layout's camera position — e.g. camera-bubble with style: full and position: bottom-left for a full-screen recording with a cut-out presenter in the corner; it switches pop-out off), blob or blob-outline. It shapes the camera bubble and the pop-out frame. Null clears it so the layout's own shape applies; omitted leaves it as it is. Needs a camera recording and a named layout that frames the camera (not cut-out, screen-only or custom; on a custom layout set presentation.shape).

durationMsinteger

Optional. Provide together with startTimeMs for a time-ranged layout. Minimum 200ms.

startTimeMsinteger

Optional. Provide together with durationMs for a time-ranged layout. In ms on the clip's playback timeline (cuts applied).

transitionStyle'spring' | 'hardCut'

How the editor transitions into this layout from the previous one. spring is the default smooth motion; hardCut is an instant cut.

Response

OK

Example response

{
  "layout": {
    "durationMs": 5000
  }
}

Changes

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