Save a subtitle preset
curl --request POST \
--url https://api.tella.com/v1/subtitle-presets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"captionFontFamily": "Inter",
"captionFontSize": 64,
"captionFontWeight": 500,
"captionLinesPerBlock": 1,
"captionPosition": {
"x": 0.5,
"y": 0.5
},
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": true,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": true,
"highlightColor": "#5E51F8FF",
"outlineColor": "#5E51F8FF",
"outlineEnabled": true,
"shadowColor": "#5E51F8FF",
"shadowEnabled": true
},
"name": "Brand captions",
"videoId": "vid_abc123"
}
'import requests
url = "https://api.tella.com/v1/subtitle-presets"
payload = {
"captionFontFamily": "Inter",
"captionFontSize": 64,
"captionFontWeight": 500,
"captionLinesPerBlock": 1,
"captionPosition": {
"x": 0.5,
"y": 0.5
},
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": True,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": True,
"highlightColor": "#5E51F8FF",
"outlineColor": "#5E51F8FF",
"outlineEnabled": True,
"shadowColor": "#5E51F8FF",
"shadowEnabled": True
},
"name": "Brand captions",
"videoId": "vid_abc123"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
captionFontFamily: 'Inter',
captionFontSize: 64,
captionFontWeight: 500,
captionLinesPerBlock: 1,
captionPosition: {x: 0.5, y: 0.5},
captionStyle: {
backgroundColor: '#5E51F8FF',
name: 'backdrop',
textColor: '#5E51F8FF',
wordLevelHighlights: true,
activeWordTextColor: '#5E51F8FF',
backgroundEnabled: true,
highlightColor: '#5E51F8FF',
outlineColor: '#5E51F8FF',
outlineEnabled: true,
shadowColor: '#5E51F8FF',
shadowEnabled: true
},
name: 'Brand captions',
videoId: 'vid_abc123'
})
};
fetch('https://api.tella.com/v1/subtitle-presets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tella.com/v1/subtitle-presets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'captionFontFamily' => 'Inter',
'captionFontSize' => 64,
'captionFontWeight' => 500,
'captionLinesPerBlock' => 1,
'captionPosition' => [
'x' => 0.5,
'y' => 0.5
],
'captionStyle' => [
'backgroundColor' => '#5E51F8FF',
'name' => 'backdrop',
'textColor' => '#5E51F8FF',
'wordLevelHighlights' => true,
'activeWordTextColor' => '#5E51F8FF',
'backgroundEnabled' => true,
'highlightColor' => '#5E51F8FF',
'outlineColor' => '#5E51F8FF',
'outlineEnabled' => true,
'shadowColor' => '#5E51F8FF',
'shadowEnabled' => true
],
'name' => 'Brand captions',
'videoId' => 'vid_abc123'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tella.com/v1/subtitle-presets"
payload := strings.NewReader("{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tella.com/v1/subtitle-presets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tella.com/v1/subtitle-presets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}"
response = http.request(request)
puts response.read_body{
"preset": {
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": true,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": true,
"highlightColor": "#5E51F8FF",
"highlightMode": "text",
"outlineColor": "#5E51F8FF",
"outlineEnabled": true,
"shadowColor": "#5E51F8FF",
"shadowEnabled": true,
"textCase": "original"
},
"name": "<string>",
"presetId": "default:spotlight",
"scope": "default"
}
}{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}{
"docsUrl": "https://docs.tella.com/",
"error": "server_error",
"message": "An unexpected error occurred"
}{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}Save a subtitle preset
Saves a subtitle look as a personal preset, like the editor’s “Save as preset”. Pass videoId to snapshot that video’s current subtitles (style, font, weight, size, position, grouping and lines per block), captionStyle to build one from scratch on the style’s defaults, or both — explicit caption fields override the video’s. Omit name for the editor’s default (the matching built-in’s name, numbered). The preset then appears in GET /v1/subtitle-presets and in the editor’s Subtitles panel, and can be applied to other videos with PUT /v1/videos//subtitle-preset.
POST
https://api.tella.com
/
v1
/
subtitle-presets
Save a subtitle preset
curl --request POST \
--url https://api.tella.com/v1/subtitle-presets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"captionFontFamily": "Inter",
"captionFontSize": 64,
"captionFontWeight": 500,
"captionLinesPerBlock": 1,
"captionPosition": {
"x": 0.5,
"y": 0.5
},
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": true,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": true,
"highlightColor": "#5E51F8FF",
"outlineColor": "#5E51F8FF",
"outlineEnabled": true,
"shadowColor": "#5E51F8FF",
"shadowEnabled": true
},
"name": "Brand captions",
"videoId": "vid_abc123"
}
'import requests
url = "https://api.tella.com/v1/subtitle-presets"
payload = {
"captionFontFamily": "Inter",
"captionFontSize": 64,
"captionFontWeight": 500,
"captionLinesPerBlock": 1,
"captionPosition": {
"x": 0.5,
"y": 0.5
},
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": True,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": True,
"highlightColor": "#5E51F8FF",
"outlineColor": "#5E51F8FF",
"outlineEnabled": True,
"shadowColor": "#5E51F8FF",
"shadowEnabled": True
},
"name": "Brand captions",
"videoId": "vid_abc123"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
captionFontFamily: 'Inter',
captionFontSize: 64,
captionFontWeight: 500,
captionLinesPerBlock: 1,
captionPosition: {x: 0.5, y: 0.5},
captionStyle: {
backgroundColor: '#5E51F8FF',
name: 'backdrop',
textColor: '#5E51F8FF',
wordLevelHighlights: true,
activeWordTextColor: '#5E51F8FF',
backgroundEnabled: true,
highlightColor: '#5E51F8FF',
outlineColor: '#5E51F8FF',
outlineEnabled: true,
shadowColor: '#5E51F8FF',
shadowEnabled: true
},
name: 'Brand captions',
videoId: 'vid_abc123'
})
};
fetch('https://api.tella.com/v1/subtitle-presets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tella.com/v1/subtitle-presets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'captionFontFamily' => 'Inter',
'captionFontSize' => 64,
'captionFontWeight' => 500,
'captionLinesPerBlock' => 1,
'captionPosition' => [
'x' => 0.5,
'y' => 0.5
],
'captionStyle' => [
'backgroundColor' => '#5E51F8FF',
'name' => 'backdrop',
'textColor' => '#5E51F8FF',
'wordLevelHighlights' => true,
'activeWordTextColor' => '#5E51F8FF',
'backgroundEnabled' => true,
'highlightColor' => '#5E51F8FF',
'outlineColor' => '#5E51F8FF',
'outlineEnabled' => true,
'shadowColor' => '#5E51F8FF',
'shadowEnabled' => true
],
'name' => 'Brand captions',
'videoId' => 'vid_abc123'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tella.com/v1/subtitle-presets"
payload := strings.NewReader("{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tella.com/v1/subtitle-presets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tella.com/v1/subtitle-presets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"captionFontFamily\": \"Inter\",\n \"captionFontSize\": 64,\n \"captionFontWeight\": 500,\n \"captionLinesPerBlock\": 1,\n \"captionPosition\": {\n \"x\": 0.5,\n \"y\": 0.5\n },\n \"captionStyle\": {\n \"backgroundColor\": \"#5E51F8FF\",\n \"name\": \"backdrop\",\n \"textColor\": \"#5E51F8FF\",\n \"wordLevelHighlights\": true,\n \"activeWordTextColor\": \"#5E51F8FF\",\n \"backgroundEnabled\": true,\n \"highlightColor\": \"#5E51F8FF\",\n \"outlineColor\": \"#5E51F8FF\",\n \"outlineEnabled\": true,\n \"shadowColor\": \"#5E51F8FF\",\n \"shadowEnabled\": true\n },\n \"name\": \"Brand captions\",\n \"videoId\": \"vid_abc123\"\n}"
response = http.request(request)
puts response.read_body{
"preset": {
"captionStyle": {
"backgroundColor": "#5E51F8FF",
"name": "backdrop",
"textColor": "#5E51F8FF",
"wordLevelHighlights": true,
"activeWordTextColor": "#5E51F8FF",
"backgroundEnabled": true,
"highlightColor": "#5E51F8FF",
"highlightMode": "text",
"outlineColor": "#5E51F8FF",
"outlineEnabled": true,
"shadowColor": "#5E51F8FF",
"shadowEnabled": true,
"textCase": "original"
},
"name": "<string>",
"presetId": "default:spotlight",
"scope": "default"
}
}{
"docsUrl": "https://docs.tella.com/",
"error": "bad_request",
"message": "The request was malformed or contained invalid parameters."
}{
"docsUrl": "https://docs.tella.com/",
"error": "unauthorized",
"message": "Authentication is required. Provide a valid API key."
}{
"docsUrl": "https://docs.tella.com/",
"error": "forbidden",
"message": "You don't have permission to access this resource."
}{
"docsUrl": "https://docs.tella.com/",
"error": "not_found",
"message": "The requested resource was not found."
}{
"docsUrl": "https://docs.tella.com/",
"error": "conflict",
"message": "The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles."
}{
"docsUrl": "https://docs.tella.com/",
"error": "rate_limited",
"message": "You have exceeded the rate limit. Please slow down."
}{
"docsUrl": "https://docs.tella.com/",
"error": "server_error",
"message": "An unexpected error occurred"
}{
"docsUrl": "https://docs.tella.com/",
"error": "not_implemented",
"message": "The requested operation is not implemented."
}{
"docsUrl": "https://docs.tella.com/",
"error": "unavailable",
"message": "A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay."
}Authorizations
API key obtained from your Tella account settings
Body
application/json
A subtitle look to save. Pass videoId to snapshot a video's current subtitles, captionStyle to build one from scratch, or both — explicit caption fields override the video's.
One of Tella's catalog font families. Defaults to the video's font, or the style's default face.
Minimum string length:
1Example:
"Inter"
Exact subtitle text size, 40 to 200. Defaults to the video's, or the style's default. Pass this or captionSize, not both.
Required range:
40 <= x <= 200Example:
64
Variable-font weight, 100 to 1000, clamped to the family's range. Defaults to the font's current weight.
Required range:
100 <= x <= 1000Example:
500
How subtitle text is grouped: sentence chunks or one word at a time. Defaults to the video's, or chunked.
Available options:
chunked, singleWord Lines per chunked caption block: 1, 2, 3, or 0 for no limit. Defaults to the video's, or 1.
Required range:
0 <= x <= 3Example:
1
Subtitle text size. Defaults to the video's, or the style's default. Pass this or captionFontSize, not both.
Available options:
small, medium, large Subtitle style for the preset. Required without videoId; with it, replaces the video's style.
- Backdrop
- Highlight
- Mono
- Cannes
- Classic
Hide child attributes
Hide child attributes
Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Available options:
backdrop Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Text color of the spoken word when highlightMode is background. Defaults to textColor.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Spoken-word color. Omit to retain the legacy text-opacity progression.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
How the spoken word is emphasized. Defaults to text.
Available options:
text, background, fadeRest Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Letter case applied to every caption word. Defaults to original.
Available options:
original, uppercase, lowercase Preset name, as shown in the editor. Defaults to the matching built-in's name, numbered past any saved preset already using it.
Required string length:
1 - 255Example:
"Brand captions"
Video whose current subtitle look to start from. Omit to build the preset from captionStyle and the style's defaults.
Minimum string length:
1Example:
"vid_abc123"
Response
Preset saved
Hide child attributes
Hide child attributes
Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.
- Backdrop
- Highlight
- Mono
- Cannes
- Classic
Hide child attributes
Hide child attributes
Caption background color in #RRGGBB or #RRGGBBAA form. Its alpha channel is rendered exactly; #RRGGBB is fully opaque. Responses use uppercase #RRGGBBAA and report the effective rendered color.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Available options:
backdrop Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Text color of the spoken word when highlightMode is background. Defaults to textColor.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Spoken-word color. Omit to retain the legacy text-opacity progression.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
How the spoken word is emphasized. Defaults to text.
Available options:
text, background, fadeRest Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern:
^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$Example:
"#5E51F8FF"
Letter case applied to every caption word. Defaults to original.
Available options:
original, uppercase, lowercase Pass this ID to PUT /v1/videos/{id}/subtitle-preset
Example:
"default:spotlight"
Available options:
default, personal Last modified on October 6, 2026
Was this page helpful?