Clips

Save a text preset

Saves a personal text preset, like the editor's "Save style" on a text overlay. The style starts from an existing text overlay when videoId and textOverlayId are given (keeping a custom font and reading the size relative to that video's canvas), else from the editor's default text look; every style field sent alongside overrides it. The preset then appears in GET /v1/text-presets and in the editor's Text panel.

post/v1/text-presets

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/text-presets
  • Auth: HTTP bearer

Request body

backgroundShape'none' | 'regular' | 'squircle'

Shape of the solid background behind the text.

colorstring

Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.

fontFamily'Inter' | 'Roboto Mono' | 'Archivo' | 'Barlow' | 'Caveat' | 'DM Sans' | 'Figtree' | 'Lora' | 'Merriweather' | 'Montserrat' | 'Nunito Sans' | 'Open Sans' | 'Oswald' | 'Playfair Display' | 'Poppins' | 'Raleway' | 'Roboto' | 'Roboto Flex' | 'Source Sans 3' | 'Space Grotesk'

One of Tella's catalog font families — the same list the editor's font picker offers.

fontSizeScalenumber

Font size relative to the editor's default (7.5% of the canvas's shorter side): 1 is the default, 0.6 a caption, 1.4 a headline. Presets are video-independent, so this is a scale rather than pixels; adding an overlay resolves it for the video it lands on.

fontWeightnumber
fontWidthnumber
namestring required
outlinestring nullable

Color of the outline (stroke) drawn around the letters, or null for no outline.

textAlign'left' | 'center' | 'right'

Horizontal alignment of the text inside its overlay box.

textOverlayIdstring

Text overlay to copy the style from, keeping a custom font and reading its size relative to that video's canvas. Goes together with videoId.

videoIdstring

Video holding the text overlay to copy the style from. Goes together with textOverlayId.

Example request

{
  "background": {
    "color": "#5E51F8FF",
    "type": "solid"
  },
  "backgroundShape": "squircle",
  "color": "#FFFFFFFF",
  "fontFamily": "Inter",
  "fontSizeScale": 0.6,
  "name": "Product callout",
  "outline": "#000000FF",
  "textAlign": "center",
  "textOverlayId": "ly_abc123",
  "videoId": "vid_abc123"
}

Response

Preset saved

Example response

{
  "preset": {
    "name": "Label",
    "presetId": "default:label",
    "style": {
      "background": {
        "color": "#5E51F8FF",
        "type": "solid"
      },
      "backgroundShape": "squircle",
      "color": "#FFFFFFFF",
      "fontFamily": "Space Grotesk",
      "fontSizeScale": 0.6,
      "fontWeight": 600,
      "fontWidth": 100,
      "outline": "#000000FF",
      "textAlign": "center"
    }
  }
}

Changes

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