Skip to main content
POST
/
v1
/
videos
/
{id}
/
clips
/
{clipId}
/
zooms
Add a zoom to a clip
curl --request POST \
  --url https://api.tella.com/v1/videos/{id}/clips/{clipId}/zooms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "durationMs": 2000,
  "startTimeMs": 1000,
  "type": "manualZoom",
  "scale": 2
}
'
{
  "zoom": {
    "durationMs": 2000,
    "id": "ef_abc123",
    "startTimeMs": 1000,
    "type": "manualZoom",
    "focusPoint": {
      "xPct": 50,
      "yPct": 50
    },
    "scale": 2
  }
}

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

Add a zoom to the clip's screen layer (does not affect the camera). Use manualZoom with a focusPoint, or trackingZoom to follow the cursor.

​
durationMs
integer
required
Required range: x <= 9007199254740991
Example:

2000

​
startTimeMs
integer
required
Required range: 0 <= x <= 9007199254740991
Example:

1000

​
type
enum<string>
required

manualZoom zooms into a fixed focusPoint on the screen. trackingZoom automatically follows the cursor in the screen recording.

Available options:
manualZoom,
trackingZoom
Example:

"manualZoom"

​
focusPoint
object

Point on the screen recording to zoom into, expressed as percentages of the screen dimensions. Required for manualZoom; ignored for trackingZoom.

​
scale
number

Magnification factor (1 = no zoom, 3.5 = max).

Required range: 1 <= x <= 3.5
Example:

2

Response

OK

A zoom on a clip

​
zoom
object
required

A zoom effect applied to the clip's screen layer (does not affect the camera). Use manualZoom with a focusPoint, or trackingZoom to follow the cursor automatically.