{
"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": "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."
}
Create a video
Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video’s first clip. Without a sourceId the video is empty, as the editor’s New video makes; add clips with POST /v1/videos//clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).
{
"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": "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
Authorization
string
header
required
API key obtained from your Tella account settings
Body
application/json
Request body for creating a video, from an uploaded source or empty.
allowedEmbedDomains
string[]
Restrict embedding to these domains only (Premium feature). Empty array allows all domains.
Example:
["example.com", "mysite.org"]
autoRatio
boolean
The editor's canvas size menu → Auto (the ratio control under the preview or in the Layout panel header). true sizes the canvas from the video's recording (the first clip with a screen recording, else the first clip's video or image) with the layout's padding equal on all sides, and keeps it following the recording as layouts change; when the canvas changes ratio class, layouts are remapped like a dimensions change. false pins the current size. Pass either autoRatio or dimensions, not both.
Example:
true
captionFontFamily
string
Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families Dela Gothic One, Lato, Georgia, and Arial, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.
Minimum string length: 1
Example:
"Inter"
captionFontSize
number
Exact subtitle text size, 40 to 200 — the editor's Size slider. captionSize is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.
Required range: 40 <= x <= 200
Example:
64
captionFontWeight
number
Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. Dela Gothic One uses 400 only; Arial uses 400 or 700. Reads report the weight that renders. Sent without captionFontFamily, it re-weights the video's current font.
Required range: 100 <= x <= 1000
Example:
500
captionGrouping
enum<string>
How subtitle text is grouped: sentence chunks or one word at a time.
Available options:
chunked,
singleWord
captionLinesPerBlock
integer
Lines a caption block may span when captionGrouping is chunked: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.
Required range: 0 <= x <= 3
Example:
1
captionPosition
object | null
Normalized subtitle position; null restores automatic placement. Applies if subtitles are enabled on the video.
Hide child attributes
captionPosition.x
number
required
Required range: 0 <= x <= 1
captionPosition.y
number
required
Required range: 0 <= x <= 1
captionSize
enum<string>
Subtitle text size. Applies if subtitles are enabled on the video.
Available options:
small,
medium,
large
captionStyle
Backdrop · object
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
captionStyle.backgroundColor
string
required
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"
captionStyle.name
enum<string>
required
Available options:
backdrop
captionStyle.textColor
string
required
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
captionStyle.wordLevelHighlights
boolean
required
captionStyle.activeWordTextColor
string
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"
captionStyle.backgroundBorderColor
string
Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
captionStyle.backgroundBorderEnabled
boolean
Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.
captionStyle.backgroundBorderWidth
number
Thickness of the background border, as a fraction of the font size. Defaults to 0.06.
Required range: 0 <= x <= 0.5
captionStyle.backgroundEnabled
boolean
captionStyle.backgroundPadding
number
Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.
Required range: 0 <= x <= 1
captionStyle.backgroundRadius
number
Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.
Required range: 0 <= x <= 2
captionStyle.highlightColor
string
Spoken-word color. Omit to retain the legacy text-opacity progression.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
captionStyle.highlightMode
enum<string>
How the spoken word is emphasized. Defaults to text.
Available options:
text,
background,
fadeRest
captionStyle.maxWidth
number
Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).
Required range: 0.3 <= x <= 1
captionStyle.outlineColor
string
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
captionStyle.outlineEnabled
boolean
captionStyle.outlineWidth
number
Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.
Required range: 0 <= x <= 0.5
captionStyle.shadowColor
string
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
captionStyle.shadowEnabled
boolean
captionStyle.textCase
enum<string>
Letter case applied to every caption word. Defaults to original.
Available options:
original,
uppercase,
lowercase
captionsDefaultEnabled
boolean
Show subtitles to viewers by default
Example:
true
commentEmailsEnabled
boolean
Send email notifications for new comments
Example:
false
commentsEnabled
boolean
Allow viewers to comment
Example:
true
creatorEnabled
boolean
Show who created the video on the video page
Example:
true
cursor
object
Animated cursor settings to update. Omitted nested fields keep their current values.
Hide child attributes
cursor.clickRipple
boolean
Show a ripple on mouse clicks. Defaults off for new videos.
Example:
false
cursor.hideWhenInactive
boolean
Fade the animated cursor out while inactive and back in when activity resumes.
Example:
false
cursor.returnToStart
boolean
Move the cursor back to its opening position at the end for cleaner loops.
Example:
false
cursor.size
number
Animated cursor size multiplier.
Required range: 0.5 <= x <= 6
Example:
3.05
cursor.smoothing
boolean
Smooth cursor movement. Defaults off for new videos.
Example:
false
cursor.style
enum<string>
Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.
Available options:
mac,
macTahoe,
macGoldenGate,
windows,
touch
Example:
"macTahoe"
cursor.tilt
boolean
Tilt the cursor in the direction it moves. Defaults off for new videos.
Example:
false
cursor.tiltStrength
number
How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.
Required range: 0 <= x <= 2
Example:
0.5
customThumbnailURL
string<uri>
Custom thumbnail image URL
Example:
"https://example.com/custom-thumbnail.jpg"
defaultClipTransition
enum<string>
How each clip enters from the previous one. A clip can override it with its own transition; see PATCH /v1/videos/{id}/clips/{clipId}.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
defaultPlaybackRate
number
Default playback speed (0.5-2.0). Viewers can still adjust.
Required range: 0.5 <= x <= 2
Example:
1
description
string
Video description
Maximum string length: 5000
Example:
"Updated description for the video"
dimensions
object
Canvas size in pixels, at most 1920 per side. This is the layout canvas, not the output resolution: request a 4K file with resolution: "4k" on POST /v1/videos/{id}/exports. Changing it also remaps every clip and section layout to a ratio-appropriate equivalent (clips using a custom layout fall back to a standard one), exactly like switching size in the editor's canvas size menu. No-op when the video already has the requested size. The editor's presets: 1920x1080 (16:9), 1920x1200 (16:10), 1440x1080 (4:3), 1080x1080 (1:1), 1080x1350 (4:5), 1080x1920 (9:16).
Hide child attributes
dimensions.height
number
required
Canvas height in pixels
Required range: 16 <= x <= 1920
Example:
1920
dimensions.width
number
required
Canvas width in pixels
Required range: 16 <= x <= 1920
Example:
1080
Example:
{ "height": 1920, "width": 1080 }
documentGenerationEnabled
boolean
Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)
Example:
true
downloadsEnabled
boolean
Allow viewers to download the video
Example:
true
eyeContact
boolean
Eye contact correction for every camera recording in the video: AI redirects the speaker's gaze to the lens. true starts preparing each camera in the background (about as long as the recording); false restores the natural look. The response's settings.eyeContact shows the switch as asked for with status: "processing"; read the video until it is ready. Screen recordings and uploaded videos are never changed. Returns 400 when turning it on for a video with no camera recording.
Example:
true
keystrokes
object
Keystroke HUD settings to update. Omitted fields keep their current values; enabled: true turns it on with the defaults. Only recordings made with the Tella Mac app and Auto Capture takes carry keyboard data.
Hide child attributes
keystrokes.alignment
enum<string>
Which horizontal edge of the HUD sits on position.x.
Available options:
left,
center,
right
Example:
"center"
keystrokes.animation
object
How each chord enters and leaves, with the same sides as an overlay's animation (no text sides). Defaults to a 150 ms fade in and a 200 ms fade out.
Hide child attributes
keystrokes.animation.intro
object | null
How the whole overlay enters, or null to appear instantly. Takes no text. Omit to keep the current intro.
Hide child attributes
keystrokes.animation.intro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
keystrokes.animation.intro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
keystrokes.animation.intro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
keystrokes.animation.intro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
keystrokes.animation.intro.easing.curve
enum<string>
required
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
keystrokes.animation.intro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
keystrokes.animation.intro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
keystrokes.animation.intro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.
Required range: -10 <= x <= 10
keystrokes.animation.intro.moveY
number
Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.
Required range: -10 <= x <= 10
keystrokes.animation.intro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
keystrokes.animation.intro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
keystrokes.animation.intro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
keystrokes.animation.intro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
keystrokes.animation.intro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
keystrokes.animation.intro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
keystrokes.animation.intro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
keystrokes.animation.intro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
keystrokes.animation.intro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
keystrokes.animation.motionBlur
boolean
Blur the overlay along its motion while it moves, scales or turns. Defaults to true.
keystrokes.animation.outro
object | null
How the whole overlay leaves, or null to disappear instantly. Takes no text. Omit to keep the current outro.
Hide child attributes
keystrokes.animation.outro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
keystrokes.animation.outro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
keystrokes.animation.outro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
keystrokes.animation.outro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
keystrokes.animation.outro.easing.curve
enum<string>
required
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
keystrokes.animation.outro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
keystrokes.animation.outro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
keystrokes.animation.outro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.
Required range: -10 <= x <= 10
keystrokes.animation.outro.moveY
number
Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.
Required range: -10 <= x <= 10
keystrokes.animation.outro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
keystrokes.animation.outro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
keystrokes.animation.outro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
keystrokes.animation.outro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
keystrokes.animation.outro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
keystrokes.animation.outro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
keystrokes.animation.outro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
keystrokes.animation.outro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
keystrokes.animation.outro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
keystrokes.animation.textIntro
object | null
Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside intro: both start together.
Hide child attributes
keystrokes.animation.textIntro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
keystrokes.animation.textIntro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
keystrokes.animation.textIntro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
keystrokes.animation.textIntro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
keystrokes.animation.textIntro.easing.curve
enum<string>
required
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
keystrokes.animation.textIntro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
keystrokes.animation.textIntro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
keystrokes.animation.textIntro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.
Required range: -10 <= x <= 10
keystrokes.animation.textIntro.moveY
number
Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.
Required range: -10 <= x <= 10
keystrokes.animation.textIntro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
keystrokes.animation.textIntro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
keystrokes.animation.textIntro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
keystrokes.animation.textIntro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
keystrokes.animation.textIntro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
keystrokes.animation.textIntro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
keystrokes.animation.textIntro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
keystrokes.animation.textIntro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
keystrokes.animation.textIntro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
overshoot,
impulse,
swing
Example:
"linear"
keystrokes.animation.textOutro
object | null
Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside outro: both end together.
Hide child attributes
keystrokes.animation.textOutro.blur
number
Blur of the hidden state in pixels.
Required range: 0 <= x <= 200
keystrokes.animation.textOutro.clip
boolean
Clip the motion to the overlay's box, so it wipes in like a mask.
keystrokes.animation.textOutro.durationMs
number
How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.
Required range: 50 <= x <= 5000
keystrokes.animation.textOutro.easing
object
How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.
Hide child attributes
keystrokes.animation.textOutro.easing.curve
enum<string>
required
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
Available options:
linear,
smooth,
natural,
slow_down,
accelerate,
elastic,
bounce,
overshoot,
impulse,
swing,
custom,
spring
Example:
"slow_down"
keystrokes.animation.textOutro.easing.bezier
number[]
For custom: the handles. Defaults to the side's current curve.
Required array length: 4 elements
Required range: 0 <= x <= 1
Example:
[0.25, 0.1, 0.25, 1]
keystrokes.animation.textOutro.easing.intensity
number
How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.
Required range: 0 <= x <= 1
keystrokes.animation.textOutro.easing.spring
object
For spring: its physics. Defaults to stiffness 200, damping 12, mass 1.
Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.
Required range: -10 <= x <= 10
keystrokes.animation.textOutro.moveY
number
Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.
Required range: -10 <= x <= 10
keystrokes.animation.textOutro.opacity
number
Opacity of the hidden state, 0 to 1.
Required range: 0 <= x <= 1
keystrokes.animation.textOutro.preset
enum<string>
Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from fade.
Available options:
fade,
slide_up,
slide_down,
slide_left,
slide_right,
mask_up,
mask_down,
grow,
shrink,
blur,
blur_slide_up
Example:
"slide_up"
keystrokes.animation.textOutro.rotate
number
Clockwise rotation of the hidden state in degrees.
Required range: -3600 <= x <= 3600
keystrokes.animation.textOutro.scale
number
Scale of the hidden state; 1 is its resting size.
Required range: 0 <= x <= 10
keystrokes.animation.textOutro.text
object
On textIntro/textOutro only: which units play the side, each in turn. Required on a new text side.
Hide child attributes
keystrokes.animation.textOutro.text.unit
enum<string>
required
What animates on its own.
Available options:
letters,
words,
lines
Example:
"words"
keystrokes.animation.textOutro.text.delayMs
number
How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.
Required range: 0 <= x <= 2000
keystrokes.animation.textOutro.text.order
enum<string>
Which unit goes first. random uses the same shuffle every time. Defaults to forward.
Available options:
forward,
backward,
center,
edges,
random
Example:
"forward"
keystrokes.animation.textOutro.text.smoothing
enum<string>
Eases the delays across the units. Defaults to linear.
How long a chord lingers after its key is released, in milliseconds.
Required range: 300 <= x <= 10000
Example:
1000
keystrokes.enabled
boolean
Show the HUD.
Example:
true
keystrokes.filter
enum<string>
shortcuts shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; all also shows plain typing, including any text typed while recording.
Available options:
shortcuts,
all
Example:
"shortcuts"
keystrokes.labels
enum<string>
The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. both shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).
Available options:
mac,
windows,
both
keystrokes.position
object
Hide child attributes
keystrokes.position.x
number
required
0 is the left edge.
Required range: 0 <= x <= 1
keystrokes.position.y
number
required
0 is the top edge.
Required range: 0 <= x <= 1
keystrokes.size
number
Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).
Required range: 0.5 <= x <= 4
Example:
1
keystrokes.style
enum<string>
keycap draws one rounded cap per key in a container; pill draws the chord as text in one box.
Available options:
keycap,
pill
Example:
"keycap"
keystrokes.typing
enum<string>
How filter: all shows plain typing. keys (the default when absent) shows one key per press; words grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.
Available options:
keys,
words
Example:
"words"
layoutAnimationStyle
enum<string>
How layout transitions animate, gentlest to snappiest. Changing it leaves zooms as they were: when zooms have no zoomAnimationStyle of their own, they keep the previous style.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest
Example:
"snappy"
linkScope
enum<string>
Access level: public (anyone with link), private (org members only), password (requires password), embedonly (only viewable when embedded)
Available options:
public,
private,
password,
embedonly
Example:
"public"
microphoneVolume
number
Volume of the microphone (webcam) audio across the whole video. 1 is the recorded level, 0 mutes it, 2 doubles it. Clips that set their own microphoneVolume keep it — change or clear those with PATCH /v1/videos/{id}/clips/{clipId}.
Required range: 0 <= x <= 2
Example:
1.2
motionBlur
boolean
Blur fast zoom, pan, and cursor movement. Defaults on for new videos.
Example:
true
motionBlurAmount
number
Motion blur strength, the editor's Motion blur slider: 0.1 (subtle) to 2 (strong), 1 is the default. Setting it turns motion blur on, so it can't be combined with motionBlur: false.
Required range: 0.1 <= x <= 2
Example:
1.3
name
string
Video title
Required string length: 1 - 255
Example:
"Updated Video Title"
password
string
Password for viewing. Required when linkScope is 'password', ignored otherwise.
Required string length: 1 - 255
Example:
"secretpassword"
publishDateEnabled
boolean
Show publish date on video page
Example:
true
rawDownloadsEnabled
boolean
Allow viewers to download raw source files
Example:
false
searchEngineIndexingEnabled
boolean
Allow search engines to index the video page
Example:
true
shrinkCameraDuringZooms
boolean
Shrink camera bubbles while a zoom is active. Defaults on.
Example:
true
sourceId
string
Source ID from POST /v1/sources (kind: 'video'). Upload the video bytes to the source's uploadUrl first; the source becomes the new video's first clip. Leave it out for an empty video, as the editor's New video makes: add clips with POST /v1/videos/{id}/clips or POST /v1/motion/clips.
Minimum string length: 1
Example:
"su_abc123def456"
studioSound
boolean
Studio Sound (AI audio enhancement) master switch. Enabling it also starts generating the enhanced audio tracks in the background; playback and exports use them once ready and fall back to the raw audio until then.
Example:
true
studioSoundLevel
enum<string>
Studio Sound level, as in the editor's Studio Voice panel. low and high turn Studio Sound on at that strength and regenerate the enhanced audio tracks when the level changes; off turns it off. Pass this or studioSound, or both when they agree.
Available options:
off,
low,
high
Example:
"low"
subtitlesEnabled
boolean
Allow viewers to enable subtitles
Example:
true
systemAudioVolume
number
Volume of the system/screen audio across the whole video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. Clips that set their own systemAudioVolume keep it — change or clear those with PATCH /v1/videos/{id}/clips/{clipId}.
Required range: 0 <= x <= 2
Example:
0.4
transcriptsEnabled
boolean
Show transcript panel to viewers
Example:
true
viewCountEnabled
boolean
Show view count on video page
Example:
true
zoomAnimationStyle
enum<string>
How zooms ease in, out, and between each other, gentlest to snappiest. Independent of layoutAnimationStyle.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest
Example:
"brisk"
Response
Video created
video
object
required
Detailed information about a video including chapters, transcript, and exports
Hide child attributes
video.aspectRatio
string
required
Video aspect ratio (e.g., '16:9', '9:16')
Example:
"16:9"
video.autoRatio
boolean
required
Whether the canvas is in Auto ratio (sized from the video's recording and following it as layouts change), the editor's canvas size menu → Auto.
Example:
false
video.backgroundMusic
object | null
required
Video-wide track that loops over the whole video and is included in exports
Hide child attributes
video.backgroundMusic.durationMs
number
required
Audio track duration in milliseconds
Required range: x > 0
Example:
180036
video.backgroundMusic.name
string | null
required
Optional display name for the track
Example:
"Calm Product Tour"
video.backgroundMusic.url
string<uri>
required
HTTPS URL of the audio track
Pattern: ^https:\/\/.*
Example:
"https://ucarecdn.com/example-track/"
video.backgroundMusic.volume
number
required
Track volume from 0 (silent) to 1 (full volume)
Required range: 0 <= x <= 1
Example:
0.2
video.chapters
object[]
required
Video chapters/sections
Hide child attributes
video.chapters.description
string
required
Chapter description
Maximum string length: 5000
Example:
"Overview of what we'll cover"
video.chapters.timestampSeconds
number
required
Chapter start time in seconds
Required range: x >= 0
Example:
0
video.chapters.title
string
required
Chapter title
Required string length: 1 - 255
Example:
"Introduction"
video.clipIds
string[]
required
Ordered IDs of the clips in the video. Use /v1/videos/{id}/clips/{clipId} to fetch each one.
Example:
["cl_abc123", "cl_def456"]
video.createdAt
string<date-time>
required
ISO 8601 datetime
Example:
"2024-01-15T10:30:00.000Z"
video.description
string
required
Video description
Maximum string length: 5000
Example:
"Learn how to create and share your first video"
video.dimensions
object
required
Canvas size in pixels
Hide child attributes
video.dimensions.height
number
required
video.dimensions.width
number
required
Example:
{ "height": 1080, "width": 1920 }
video.durationSeconds
number
required
Video duration in seconds
Required range: x >= 0
Example:
125.5
video.exports
object[]
required
Available exports and their status
Hide child attributes
video.exports.downloadUrl
string<uri> | null
required
Download URL when export is completed, null otherwise
Restrict embedding to these domains only (Premium feature). Empty array allows all domains.
Example:
["example.com", "mysite.org"]
video.settings.callToAction
object | null
required
The video's own call-to-action button on its share page. null when it has none, in which case workspaceCallToAction shows instead.
Hide child attributes
video.settings.callToAction.label
string
required
Button text
Required string length: 1 - 100
video.settings.callToAction.url
string
required
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
video.settings.callToActionsHidden
boolean
required
Every call-to-action button is hidden on the share page, the workspace defaults included.
video.settings.captionFontFamily
string
required
Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families Dela Gothic One, Lato, Georgia, and Arial, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.
Minimum string length: 1
Example:
"Inter"
video.settings.captionFontSize
number
required
Exact subtitle text size, 40 to 200 — the editor's Size slider. captionSize is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.
Required range: 40 <= x <= 200
Example:
64
video.settings.captionFontWeight
number
required
Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. Dela Gothic One uses 400 only; Arial uses 400 or 700. Reads report the weight that renders. Sent without captionFontFamily, it re-weights the video's current font.
Required range: 100 <= x <= 1000
Example:
500
video.settings.captionGrouping
enum<string>
required
How subtitle text is grouped: sentence chunks or one word at a time.
Available options:
chunked,
singleWord
Example:
"chunked"
video.settings.captionLinesPerBlock
integer
required
Lines a caption block may span when captionGrouping is chunked: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.
Required range: 0 <= x <= 3
Example:
1
video.settings.captionPosition
object | null
required
Normalized subtitle position, or null for automatic placement. Applies if subtitles are enabled on the video.
Hide child attributes
video.settings.captionPosition.x
number
required
Required range: 0 <= x <= 1
video.settings.captionPosition.y
number
required
Required range: 0 <= x <= 1
video.settings.captionSize
enum<string>
required
Subtitle text size. Applies if subtitles are enabled on the video.
Available options:
small,
medium,
large
Example:
"medium"
video.settings.captionStyle
Backdrop · object
required
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
video.settings.captionStyle.backgroundColor
string
required
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"
video.settings.captionStyle.name
enum<string>
required
Available options:
backdrop
video.settings.captionStyle.textColor
string
required
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
video.settings.captionStyle.wordLevelHighlights
boolean
required
video.settings.captionStyle.activeWordTextColor
string
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"
video.settings.captionStyle.backgroundBorderColor
string
Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.
Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.
video.settings.captionStyle.backgroundBorderWidth
number
Thickness of the background border, as a fraction of the font size. Defaults to 0.06.
Required range: 0 <= x <= 0.5
video.settings.captionStyle.backgroundEnabled
boolean
video.settings.captionStyle.backgroundPadding
number
Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.
Required range: 0 <= x <= 1
video.settings.captionStyle.backgroundRadius
number
Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.
Required range: 0 <= x <= 2
video.settings.captionStyle.highlightColor
string
Spoken-word color. Omit to retain the legacy text-opacity progression.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
video.settings.captionStyle.highlightMode
enum<string>
How the spoken word is emphasized. Defaults to text.
Available options:
text,
background,
fadeRest
video.settings.captionStyle.maxWidth
number
Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).
Required range: 0.3 <= x <= 1
video.settings.captionStyle.outlineColor
string
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
video.settings.captionStyle.outlineEnabled
boolean
video.settings.captionStyle.outlineWidth
number
Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.
Required range: 0 <= x <= 0.5
video.settings.captionStyle.shadowColor
string
Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.
Pattern: ^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$
Example:
"#5E51F8FF"
video.settings.captionStyle.shadowEnabled
boolean
video.settings.captionStyle.textCase
enum<string>
Letter case applied to every caption word. Defaults to original.
Available options:
original,
uppercase,
lowercase
video.settings.captionsDefaultEnabled
boolean
required
Show subtitles to viewers by default
Example:
true
video.settings.commentEmailsEnabled
boolean
required
Send email notifications for new comments
Example:
false
video.settings.commentsEnabled
boolean
required
Allow viewers to comment
Example:
true
video.settings.creatorEnabled
boolean
required
Show who created the video on the video page
Example:
true
video.settings.cursor
object
required
Animated cursor settings
Hide child attributes
video.settings.cursor.clickRipple
boolean
required
Show a ripple on mouse clicks. Defaults off for new videos.
Example:
false
video.settings.cursor.hideWhenInactive
boolean
required
Fade the animated cursor out while inactive and back in when activity resumes.
Example:
false
video.settings.cursor.returnToStart
boolean
required
Move the cursor back to its opening position at the end for cleaner loops.
Example:
false
video.settings.cursor.size
number
required
Animated cursor size multiplier.
Required range: 0.5 <= x <= 6
Example:
3.05
video.settings.cursor.smoothing
boolean
required
Smooth cursor movement. Defaults off for new videos.
Example:
false
video.settings.cursor.style
enum<string>
required
Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.
Available options:
mac,
macTahoe,
macGoldenGate,
windows,
touch
Example:
"macTahoe"
video.settings.cursor.tilt
boolean
required
Tilt the cursor in the direction it moves. Defaults off for new videos.
Example:
false
video.settings.cursor.tiltStrength
number
required
How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.
Required range: 0 <= x <= 2
Example:
0.5
video.settings.customThumbnailURL
string<uri> | null
required
Custom thumbnail image URL
Example:
"https://example.com/custom-thumbnail.jpg"
video.settings.defaultClipTransition
enum<string>
required
How each clip enters from the previous one, unless the clip overrides it via its own transition.
Available options:
smooth,
hard_cut
Example:
"hard_cut"
video.settings.defaultPlaybackRate
number
required
Default playback speed (0.5-2.0). Viewers can still adjust.
Required range: 0.5 <= x <= 2
Example:
1
video.settings.documentGenerationEnabled
boolean
required
Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)
Example:
true
video.settings.downloadsEnabled
boolean
required
Allow viewers to download the video
Example:
true
video.settings.layoutAnimationStyle
enum<string>
required
How layout transitions animate, gentlest to snappiest. Zooms have their own zoomAnimationStyle. custom is a spring set outside the named styles.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest,
custom
Example:
"moderate"
video.settings.linkScope
enum<string>
required
Current access level, including org for workspace-visible videos
Available options:
public,
private,
org,
password,
embedonly
Example:
"org"
video.settings.microphoneVolume
number
required
Volume of the microphone (webcam) audio across the video. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.
Required range: 0 <= x <= 2
Example:
1
video.settings.motionBlur
boolean
required
Blur fast zoom, pan, and cursor movement. Defaults on for new videos.
Example:
true
video.settings.publishDateEnabled
boolean
required
Show publish date on video page
Example:
true
video.settings.rawDownloadsEnabled
boolean
required
Allow viewers to download raw source files
Example:
false
video.settings.searchEngineIndexingEnabled
boolean
required
Allow search engines to index the video page
Example:
true
video.settings.secondaryCallToAction
object | null
required
The video's own second button, next to callToAction. null when it has none, in which case workspaceSecondaryCallToAction shows instead.
Hide child attributes
video.settings.secondaryCallToAction.label
string
required
Button text
Required string length: 1 - 100
video.settings.secondaryCallToAction.url
string
required
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
video.settings.shrinkCameraDuringZooms
boolean
required
Shrink camera bubbles while a zoom is active. Defaults on.
Example:
true
video.settings.studioSound
boolean
required
Studio Sound (AI audio enhancement) master switch for the video. Individual clips can opt out via the clip's studioSound field.
Example:
false
video.settings.studioSoundLevel
enum<string>
required
Studio Sound level, as in the editor's Studio Voice panel: off, low or high.
Available options:
off,
low,
high
Example:
"off"
video.settings.subtitlesEnabled
boolean
required
Allow viewers to enable subtitles
Example:
true
video.settings.systemAudioVolume
number
required
Volume of the system/screen audio across the video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.
Required range: 0 <= x <= 2
Example:
1
video.settings.thumbnailInpointMs
integer | null
required
Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via inpointMs). Null when the thumbnail is an uploaded image or the default. A picked frame leaves customThumbnailURL null, so check this field to verify it.
Required range: 0 <= x <= 9007199254740991
Example:
12000
video.settings.transcriptsEnabled
boolean
required
Show transcript panel to viewers
Example:
true
video.settings.viewCountEnabled
boolean
required
Show view count on video page
Example:
true
video.settings.workspaceCallToAction
object | null
required
The workspace's default button (Settings → CTA button), shown when the video has no callToAction of its own. Read-only here.
Hide child attributes
video.settings.workspaceCallToAction.label
string
required
Button text
Required string length: 1 - 100
video.settings.workspaceCallToAction.url
string
required
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
video.settings.workspaceSecondaryCallToAction
object | null
required
The workspace's default second button, shown when the video has no secondaryCallToAction of its own. Read-only here.
Where the button links, starting https:// or http://
Example:
"https://docs.tella.com/help"
video.settings.zoomAnimationStyle
enum<string>
required
How zooms ease in, out, and between each other, gentlest to snappiest. Zooms follow layoutAnimationStyle until one is set. custom is a spring set outside the named styles.
Available options:
gentlest,
gentle,
relaxed,
smooth,
moderate,
brisk,
focused,
snappy,
punchy,
snappiest,
custom
Example:
"moderate"
video.settings.eyeContact
object
Eye contact correction: AI redirects the speaker's gaze to the camera lens in every camera recording. Only returned to callers who can edit the video, on the video itself (not the timeline).
Hide child attributes
video.settings.eyeContact.cameras
integer
required
Camera recordings in the video. Screen recordings and uploaded videos are never changed.
Required range: 0 <= x <= 9007199254740991
Example:
1
video.settings.eyeContact.camerasReady
integer
required
Camera recordings that have their corrected version
Required range: 0 <= x <= 9007199254740991
Example:
1
video.settings.eyeContact.enabled
boolean
required
Whether eye contact correction is on for the video
Example:
true
video.settings.eyeContact.status
enum<string>
required
processing while the last switch is being applied (cameras are being prepared, or it is turning off); ready once every camera has its corrected version; failed when it is on but some cameras couldn't be prepared (those keep their original look); off when it is off.
Available options:
off,
processing,
ready,
failed
Example:
"ready"
video.settings.keystrokes
object
The keystroke HUD, once someone has configured it on the video.
Hide child attributes
video.settings.keystrokes.alignment
enum<string>
required
Which horizontal edge of the HUD sits on position.x.
Available options:
left,
center,
right
Example:
"center"
video.settings.keystrokes.animation
object
required
How each chord enters and leaves. The text sides are always null.
Hide child attributes
video.settings.keystrokes.animation.intro
object | null
required
How the whole overlay enters, or null when it appears instantly.
Hide child attributes
video.settings.keystrokes.animation.intro.blur
number
required
Blur of the hidden state in pixels.
Example:
0
video.settings.keystrokes.animation.intro.clip
boolean
required
Clip the motion to the overlay's box, so it wipes in like a mask.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How a side accelerates. linear keeps one speed. smooth, natural, slow_down, accelerate, elastic, bounce, overshoot, impulse and swing are shaped by intensity. custom follows bezier, spring follows spring.
How long a chord lingers after its key is released, in milliseconds.
Required range: 300 <= x <= 10000
Example:
1000
video.settings.keystrokes.enabled
boolean
required
Show the HUD.
Example:
true
video.settings.keystrokes.filter
enum<string>
required
shortcuts shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; all also shows plain typing, including any text typed while recording.
Available options:
shortcuts,
all
Example:
"shortcuts"
video.settings.keystrokes.position
object
required
Anchor of the HUD as a fraction of the frame. alignment says which horizontal edge of the HUD sits on x.
Hide child attributes
video.settings.keystrokes.position.x
number
required
0 is the left edge.
Required range: 0 <= x <= 1
video.settings.keystrokes.position.y
number
required
0 is the top edge.
Required range: 0 <= x <= 1
video.settings.keystrokes.size
number
required
Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).
Required range: 0.5 <= x <= 4
Example:
1
video.settings.keystrokes.style
enum<string>
required
keycap draws one rounded cap per key in a container; pill draws the chord as text in one box.
Available options:
keycap,
pill
Example:
"keycap"
video.settings.keystrokes.labels
enum<string>
The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. both shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).
Available options:
mac,
windows,
both
video.settings.keystrokes.typing
enum<string>
How filter: all shows plain typing. keys (the default when absent) shows one key per press; words grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.
Available options:
keys,
words
Example:
"words"
video.settings.motionBlurAmount
number
Motion blur strength, 0.1 (subtle) to 2 (strong); 1 is the default. Absent while motion blur is off.
Example:
1
video.thumbnails
object
required
Available thumbnail URLs by format and resolution
Hide child attributes
video.thumbnails.large
object
Large thumbnails (1280x720 landscape, 720x1280 portrait, 1080x1080 square)
Hide child attributes
video.thumbnails.large.gif
string<uri>
Animated GIF thumbnail URL (medium and small sizes only)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"Tella","colors":{"primary":"#8278FA","light":"#B1AAFC","dark":"#5E51F8"},"logo":{"light":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf","dark":"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-dark.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=88323f6b0165ce29c00e3a1d80c82fe3"},"favicon":"https://mintcdn.com/tella/munSRGpiNeMNXMvc/favicon.svg?fit=max\u0026auto=format\u0026n=munSRGpiNeMNXMvc\u0026q=85\u0026s=1b25a4dc5d9a41a1a9238eda432a0cb6","api":{"params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"all","prefill":true},"url":"full","mdx":{"auth":{"method":"bearer"}}},"navbar":{"primary":{"type":"button","label":"Open Tella","href":"https://www.tella.com/videos"}},"footer":{"socials":{"github":"https://github.com/tellahq","x":"https://x.com/tellahq","linkedin":"https://linkedin.com/company/tellahq","youtube":"https://youtube.com/@tellahq","website":"https://tella.com","instagram":"https://instagram.com/tellahq"},"links":[{"header":"Tella features","items":[{"label":"Video trimming","href":"https://www.tella.com/features/video-trimming"},{"label":"Viewer downloads","href":"https://www.tella.com/features/viewer-download"},{"label":"4K export","href":"https://www.tella.com/features/4k-export"},{"label":"AI editing","href":"https://www.tella.com/features/ai-editing"},{"label":"Custom branding","href":"https://www.tella.com/features/custom-branding"},{"label":"Upload video","href":"https://www.tella.com/features/video-upload"},{"label":"Video clips","href":"https://www.tella.com/features/clips"},{"label":"Custom backgrounds","href":"https://www.tella.com/features/custom-backgrounds"},{"label":"All features","href":"https://www.tella.com/features"}]}]},"seo":{"paths":[{"path":"help","metatags":{"canonical":"https://www.tella.com"}},{"path":"changelog","metatags":{"canonical":"https://www.tella.com"}}]},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"contextual":{"options":["copy","assistant","view","chatgpt","claude","perplexity","grok","mcp","add-mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tella","hasAudioNarration":false,"actualSubdomain":"tella","customDomains":["www.tella.com"],"gitSource":{"type":"github","owner":"tellahq","repo":"tella-fusion","deployBranch":"main","contentDirectory":"packages/core/webapp/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":true},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00ef34c953c2aa6bb620f0","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Help Center","count":272},{"language":"default","tag":"Developers","count":216},{"language":"default","tag":"API Reference","count":163},{"language":"default","tag":"Edit","count":75},{"language":"default","tag":"Clips","count":63},{"language":"default","tag":"Share and embed","count":41},{"language":"default","tag":"Videos","count":40},{"language":"default","tag":"MCP Tools","count":35},{"language":"default","tag":"Troubleshooting and support","count":33},{"language":"default","tag":"Account and workspace","count":31}],"searchSettings":{"isFiltersEnabled":true,"maxResults":15,"showContentSnippets":true,"fullPageSearch":true}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"type":"email","email":"support@tella.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/videos/create-a-video","slug":"/api-reference/videos/create-a-video","pageMetadata":{"title":"Create a video","description":"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video's first clip. Without a sourceId the video is empty, as the editor's New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video’s first clip. Without a sourceId the video is empty, as the editor’s New video makes; add clips with POST /v1/videos/\", \"/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create a video","description":"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video's first clip. Without a sourceId the video is empty, as the editor's New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/tella/0df50391d431fa00/support-chat.js","/docs/_mintlify/custom/tella/7e6fe091e3982139/lettervisit.js"],"openApiReferenceData":{"operation":{"description":"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video's first clip. Without a sourceId the video is empty, as the editor's New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).","operationId":"createVideo","requestBody":"103fe8e1-e40a-4714-8d22-27fd5888ff0e","responses":{"201":"fec9b987-931d-45e7-9850-1a10bff605d2","400":"b9ac1dcd-ca4c-40d8-a21f-b2384d4472a2","401":"7310b59b-f2c2-4659-8aee-b14724bed1c3","403":"7292be94-4366-48b9-adc2-075b837e2041","404":"60c5695a-bc52-49db-99fe-b39502629741","409":"753fcb5b-dacd-4699-9670-7298895da350","429":"d3362cea-cf07-46a1-9037-95e2dc030c68","500":"3cb283de-c3a4-4de4-9e89-500df0315e2d","501":"5fb9c83f-fce1-4d38-b370-67f0307bd2ed","503":"29c34808-cc0d-427c-81cb-0523a1d23fdb"},"security":["fa6c1770-cd6c-4754-a024-716724c7a7a4"],"summary":"Create a video","tags":["Videos"],"method":"post","type":"path","servers":["d2aabac2-b2bc-4b47-a6f4-a26614a56f79"],"path":"/v1/videos","baseUrlOptions":["https://api.tella.com"],"title":"Create a video","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.allowedEmbedDomains.items.0":"example.com","body.allowedEmbedDomains.items.1":"mysite.org","body.autoRatio":true,"body.captionFontFamily":"Inter","body.captionFontSize":64,"body.captionFontWeight":500,"body.captionLinesPerBlock":1,"body.captionPosition.oneOf.0.x":0.5,"body.captionPosition.oneOf.0.y":0.5,"body.captionStyle.oneOf.0.backgroundColor":"#5E51F8FF","body.captionStyle.oneOf.0.name":"backdrop","body.captionStyle.oneOf.0.textColor":"#5E51F8FF","body.captionStyle.oneOf.0.wordLevelHighlights":true,"body.captionStyle.oneOf.0.activeWordTextColor":"#5E51F8FF","body.captionStyle.oneOf.0.backgroundBorderColor":"#5E51F8FF","body.captionStyle.oneOf.0.backgroundBorderEnabled":true,"body.captionStyle.oneOf.0.backgroundBorderWidth":0.25,"body.captionStyle.oneOf.0.backgroundEnabled":true,"body.captionStyle.oneOf.0.backgroundPadding":0.5,"body.captionStyle.oneOf.0.backgroundRadius":1,"body.captionStyle.oneOf.0.highlightColor":"#5E51F8FF","body.captionStyle.oneOf.0.maxWidth":0.65,"body.captionStyle.oneOf.0.outlineColor":"#5E51F8FF","body.captionStyle.oneOf.0.outlineEnabled":true,"body.captionStyle.oneOf.0.outlineWidth":0.25,"body.captionStyle.oneOf.0.shadowColor":"#5E51F8FF","body.captionStyle.oneOf.0.shadowEnabled":true,"body.captionsDefaultEnabled":true,"body.commentEmailsEnabled":false,"body.commentsEnabled":true,"body.creatorEnabled":true,"body.cursor.clickRipple":false,"body.cursor.hideWhenInactive":false,"body.cursor.returnToStart":false,"body.cursor.size":3.05,"body.cursor.smoothing":false,"body.cursor.style":"macTahoe","body.cursor.tilt":false,"body.cursor.tiltStrength":0.5,"body.customThumbnailURL":"https://example.com/custom-thumbnail.jpg","body.defaultClipTransition":"hard_cut","body.defaultPlaybackRate":1,"body.description":"Updated description for the video","body.dimensions.height":1920,"body.dimensions.width":1080,"body.documentGenerationEnabled":true,"body.downloadsEnabled":true,"body.eyeContact":true,"body.keystrokes.alignment":"center","body.keystrokes.animation.intro.oneOf.0.preset":"slide_up","body.keystrokes.animation.outro.oneOf.0.preset":"fade","body.keystrokes.colors.background":"#FFFFFF","body.keystrokes.colors.keyBackground":"#FFFFFF","body.keystrokes.colors.keyText":"#FFFFFF","body.keystrokes.displayDurationMs":1000,"body.keystrokes.enabled":true,"body.keystrokes.filter":"shortcuts","body.keystrokes.size":1,"body.keystrokes.style":"keycap","body.keystrokes.typing":"words","body.layoutAnimationStyle":"snappy","body.linkScope":"public","body.microphoneVolume":1.2,"body.motionBlur":true,"body.motionBlurAmount":1.3,"body.name":"Updated Video Title","body.password":"secretpassword","body.publishDateEnabled":true,"body.rawDownloadsEnabled":false,"body.searchEngineIndexingEnabled":true,"body.shrinkCameraDuringZooms":true,"body.sourceId":"su_abc123def456","body.studioSound":true,"body.studioSoundLevel":"low","body.subtitlesEnabled":true,"body.systemAudioVolume":0.4,"body.transcriptsEnabled":true,"body.viewCountEnabled":true,"body.zoomAnimationStyle":"brisk"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Request body for creating a video, from an uploaded source or empty.","properties":{"allowedEmbedDomains":{"description":"Restrict embedding to these domains only (Premium feature). Empty array allows all domains.","example":["example.com","mysite.org"],"items":{"type":"string","uniqueKey":"allowedEmbedDomains.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"allowedEmbedDomains","typeLabel":"string[]"},"autoRatio":{"description":"The editor's canvas size menu → Auto (the ratio control under the preview or in the Layout panel header). true sizes the canvas from the video's recording (the first clip with a screen recording, else the first clip's video or image) with the layout's padding equal on all sides, and keeps it following the recording as layouts change; when the canvas changes ratio class, layouts are remapped like a dimensions change. false pins the current size. Pass either autoRatio or dimensions, not both.","example":true,"type":"boolean","uniqueKey":"autoRatio","typeLabel":"boolean"},"captionFontFamily":{"type":"string","description":"Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families `Dela Gothic One`, `Lato`, `Georgia`, and `Arial`, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.","minLength":1,"example":"Inter","uniqueKey":"captionFontFamily","typeLabel":"string"},"captionFontSize":{"type":"number","description":"Exact subtitle text size, 40 to 200 — the editor's Size slider. `captionSize` is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.","maximum":200,"minimum":40,"example":64,"uniqueKey":"captionFontSize","typeLabel":"number"},"captionFontWeight":{"type":"number","description":"Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. `Dela Gothic One` uses 400 only; `Arial` uses 400 or 700. Reads report the weight that renders. Sent without `captionFontFamily`, it re-weights the video's current font.","maximum":1000,"minimum":100,"example":500,"uniqueKey":"captionFontWeight","typeLabel":"number"},"captionGrouping":{"description":"How subtitle text is grouped: sentence chunks or one word at a time.","enum":["chunked","singleWord"],"type":"string","uniqueKey":"captionGrouping","typeLabel":"enum\u003cstring>"},"captionLinesPerBlock":{"type":"integer","description":"Lines a caption block may span when `captionGrouping` is `chunked`: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.","maximum":3,"minimum":0,"example":1,"uniqueKey":"captionLinesPerBlock","typeLabel":"integer"},"captionPosition":{"oneOf":[{"type":"object","description":"Normalized subtitle position; null restores automatic placement. Applies if subtitles are enabled on the video.","required":["x","y"],"properties":{"x":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"captionPosition.oneOf.0.x","typeLabel":"number"},"y":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"captionPosition.oneOf.0.y","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"captionPosition.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"captionPosition.oneOf.1","typeLabel":"null"}],"uniqueKey":"captionPosition","typeLabel":"object | null"},"captionSize":{"description":"Subtitle text size. Applies if subtitles are enabled on the video.","enum":["small","medium","large"],"type":"string","uniqueKey":"captionSize","typeLabel":"enum\u003cstring>"},"captionStyle":{"oneOf":[{"type":"object","title":"Backdrop","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["backgroundColor","name","textColor","wordLevelHighlights"],"properties":{"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.0.backgroundColor","typeLabel":"string"},"name":{"enum":["backdrop"],"type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.0.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.0.textColor","typeLabel":"string"},"wordLevelHighlights":{"type":"boolean","isRequired":true,"uniqueKey":"captionStyle.oneOf.0.wordLevelHighlights","typeLabel":"boolean"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.0.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.0.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"captionStyle.oneOf.0.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.0.backgroundBorderWidth","typeLabel":"number"},"backgroundEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.0.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.0.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.0.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Omit to retain the legacy text-opacity progression.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.0.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"captionStyle.oneOf.0.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"captionStyle.oneOf.0.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.0.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.0.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.0.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.0.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.0.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"captionStyle.oneOf.0.textCase","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"captionStyle.oneOf.0","typeLabel":"Backdrop · object"},{"type":"object","title":"Highlight","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","primaryTextColor","secondaryTextColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.1.highlightColor","typeLabel":"string"},"name":{"enum":["highlight"],"type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.1.name","typeLabel":"enum\u003cstring>"},"primaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.1.primaryTextColor","typeLabel":"string"},"secondaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.1.secondaryTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.1.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"captionStyle.oneOf.1.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.1.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.1.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.1.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.1.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.1.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to background.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"captionStyle.oneOf.1.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"captionStyle.oneOf.1.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.1.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.1.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.1.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.1.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.1.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"captionStyle.oneOf.1.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"captionStyle.oneOf.1.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"captionStyle.oneOf.1","typeLabel":"Highlight · object"},{"type":"object","title":"Mono","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","textColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.2.highlightColor","typeLabel":"string"},"name":{"enum":["mono"],"type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.2.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.2.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.2.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.2.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"captionStyle.oneOf.2.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.2.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.2.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.2.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.2.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.2.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"captionStyle.oneOf.2.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"captionStyle.oneOf.2.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.2.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.2.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.2.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.2.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.2.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"captionStyle.oneOf.2.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"captionStyle.oneOf.2.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"captionStyle.oneOf.2","typeLabel":"Mono · object"},{"type":"object","title":"Cannes","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["shadowColor","name","textColor"],"properties":{"name":{"enum":["cannes"],"type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.3.name","typeLabel":"enum\u003cstring>"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.3.shadowColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.3.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.3.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.3.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"captionStyle.oneOf.3.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.3.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.3.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.3.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.3.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.3.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.3.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"captionStyle.oneOf.3.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"captionStyle.oneOf.3.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.3.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.3.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.3.outlineWidth","typeLabel":"number"},"shadowEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.3.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"captionStyle.oneOf.3.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"captionStyle.oneOf.3.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"captionStyle.oneOf.3","typeLabel":"Cannes · object"},{"type":"object","title":"Classic","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["outlineColor","name","textColor"],"properties":{"name":{"enum":["classic"],"type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.4.name","typeLabel":"enum\u003cstring>"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.4.outlineColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"captionStyle.oneOf.4.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.4.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.4.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"captionStyle.oneOf.4.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.4.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.4.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.4.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.4.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.4.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.4.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"captionStyle.oneOf.4.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"captionStyle.oneOf.4.maxWidth","typeLabel":"number"},"outlineEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.4.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"captionStyle.oneOf.4.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"captionStyle.oneOf.4.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"captionStyle.oneOf.4.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"captionStyle.oneOf.4.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"captionStyle.oneOf.4.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"captionStyle.oneOf.4","typeLabel":"Classic · object"}],"uniqueKey":"captionStyle","typeLabel":"Backdrop · object | Highlight · object | Mono · object | Cannes · object | Classic · object"},"captionsDefaultEnabled":{"description":"Show subtitles to viewers by default","example":true,"type":"boolean","uniqueKey":"captionsDefaultEnabled","typeLabel":"boolean"},"commentEmailsEnabled":{"description":"Send email notifications for new comments","example":false,"type":"boolean","uniqueKey":"commentEmailsEnabled","typeLabel":"boolean"},"commentsEnabled":{"description":"Allow viewers to comment","example":true,"type":"boolean","uniqueKey":"commentsEnabled","typeLabel":"boolean"},"creatorEnabled":{"description":"Show who created the video on the video page","example":true,"type":"boolean","uniqueKey":"creatorEnabled","typeLabel":"boolean"},"cursor":{"type":"object","description":"Animated cursor settings to update. Omitted nested fields keep their current values.","properties":{"clickRipple":{"description":"Show a ripple on mouse clicks. Defaults off for new videos.","example":false,"type":"boolean","uniqueKey":"cursor.clickRipple","typeLabel":"boolean"},"hideWhenInactive":{"description":"Fade the animated cursor out while inactive and back in when activity resumes.","example":false,"type":"boolean","uniqueKey":"cursor.hideWhenInactive","typeLabel":"boolean"},"returnToStart":{"description":"Move the cursor back to its opening position at the end for cleaner loops.","example":false,"type":"boolean","uniqueKey":"cursor.returnToStart","typeLabel":"boolean"},"size":{"description":"Animated cursor size multiplier.","example":3.05,"maximum":6,"minimum":0.5,"type":"number","uniqueKey":"cursor.size","typeLabel":"number"},"smoothing":{"description":"Smooth cursor movement. Defaults off for new videos.","example":false,"type":"boolean","uniqueKey":"cursor.smoothing","typeLabel":"boolean"},"style":{"type":"string","description":"Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.","enum":["mac","macTahoe","macGoldenGate","windows","touch"],"example":"macTahoe","uniqueKey":"cursor.style","typeLabel":"enum\u003cstring>"},"tilt":{"description":"Tilt the cursor in the direction it moves. Defaults off for new videos.","example":false,"type":"boolean","uniqueKey":"cursor.tilt","typeLabel":"boolean"},"tiltStrength":{"description":"How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.","example":0.5,"maximum":2,"minimum":0,"type":"number","uniqueKey":"cursor.tiltStrength","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"cursor","typeLabel":"object"},"customThumbnailURL":{"description":"Custom thumbnail image URL","example":"https://example.com/custom-thumbnail.jpg","format":"uri","type":"string","uniqueKey":"customThumbnailURL","typeLabel":"string\u003curi>"},"defaultClipTransition":{"type":"string","description":"How each clip enters from the previous one. A clip can override it with its own `transition`; see `PATCH /v1/videos/{id}/clips/{clipId}`.","enum":["smooth","hard_cut"],"example":"hard_cut","uniqueKey":"defaultClipTransition","typeLabel":"enum\u003cstring>"},"defaultPlaybackRate":{"description":"Default playback speed (0.5-2.0). Viewers can still adjust.","example":1,"maximum":2,"minimum":0.5,"type":"number","uniqueKey":"defaultPlaybackRate","typeLabel":"number"},"description":{"description":"Video description","example":"Updated description for the video","maxLength":5000,"type":"string","uniqueKey":"description","typeLabel":"string"},"dimensions":{"description":"Canvas size in pixels, at most 1920 per side. This is the layout canvas, not the output resolution: request a 4K file with `resolution: \"4k\"` on `POST /v1/videos/{id}/exports`. Changing it also remaps every clip and section layout to a ratio-appropriate equivalent (clips using a custom layout fall back to a standard one), exactly like switching size in the editor's canvas size menu. No-op when the video already has the requested size. The editor's presets: 1920x1080 (16:9), 1920x1200 (16:10), 1440x1080 (4:3), 1080x1080 (1:1), 1080x1350 (4:5), 1080x1920 (9:16).","example":{"height":1920,"width":1080},"properties":{"height":{"description":"Canvas height in pixels","example":1920,"maximum":1920,"minimum":16,"type":"number","isRequired":true,"uniqueKey":"dimensions.height","typeLabel":"number"},"width":{"description":"Canvas width in pixels","example":1080,"maximum":1920,"minimum":16,"type":"number","isRequired":true,"uniqueKey":"dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","uniqueKey":"dimensions","typeLabel":"object"},"documentGenerationEnabled":{"description":"Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)","example":true,"type":"boolean","uniqueKey":"documentGenerationEnabled","typeLabel":"boolean"},"downloadsEnabled":{"description":"Allow viewers to download the video","example":true,"type":"boolean","uniqueKey":"downloadsEnabled","typeLabel":"boolean"},"eyeContact":{"description":"Eye contact correction for every camera recording in the video: AI redirects the speaker's gaze to the lens. `true` starts preparing each camera in the background (about as long as the recording); `false` restores the natural look. The response's `settings.eyeContact` shows the switch as asked for with `status: \"processing\"`; read the video until it is `ready`. Screen recordings and uploaded videos are never changed. Returns 400 when turning it on for a video with no camera recording.","example":true,"type":"boolean","uniqueKey":"eyeContact","typeLabel":"boolean"},"keystrokes":{"type":"object","description":"Keystroke HUD settings to update. Omitted fields keep their current values; `enabled: true` turns it on with the defaults. Only recordings made with the Tella Mac app and Auto Capture takes carry keyboard data.","properties":{"alignment":{"description":"Which horizontal edge of the HUD sits on position.x.","enum":["left","center","right"],"example":"center","type":"string","uniqueKey":"keystrokes.alignment","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How each chord enters and leaves, with the same sides as an overlay's `animation` (no text sides). Defaults to a 150 ms fade in and a 200 ms fade out.","example":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null to appear instantly. Takes no `text`. Omit to keep the current intro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"keystrokes.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"keystrokes.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.intro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"keystrokes.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"keystrokes.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"keystrokes.animation.intro.oneOf.1","typeLabel":"null"}],"uniqueKey":"keystrokes.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns. Defaults to true.","type":"boolean","uniqueKey":"keystrokes.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null to disappear instantly. Takes no `text`. Omit to keep the current outro.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"keystrokes.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"keystrokes.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.outro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"keystrokes.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"keystrokes.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"keystrokes.animation.outro.oneOf.1","typeLabel":"null"}],"uniqueKey":"keystrokes.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines enter, one after another, or null for none. Plays alongside `intro`: both start together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"keystrokes.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"keystrokes.animation.textIntro.oneOf.1","typeLabel":"null"}],"uniqueKey":"keystrokes.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"Text overlays only: how its letters, words or lines leave, one after another, or null for none. Plays alongside `outro`: both end together.","properties":{"blur":{"description":"Blur of the hidden state in pixels.","maximum":200,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","type":"boolean","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays. Defaults to 500.","maximum":5000,"minimum":50,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.durationMs","typeLabel":"number"},"easing":{"type":"object","description":"How the side accelerates. Without it a new side slows down into place on the way in and speeds up on the way out.","required":["curve"],"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"bezier":{"description":"For `custom`: the handles. Defaults to the side's current curve.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it. Defaults to 0.5.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"spring":{"type":"object","description":"For `spring`: its physics. Defaults to stiffness 200, damping 12, mass 1.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","maximum":10,"minimum":-10,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","maximum":1,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"type":"string","description":"Start from a ready-made side; the other fields adjust it. Without it the side starts from what it is now; a new whole side starts still and a new text side from `fade`.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring>"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","maximum":3600,"minimum":-3600,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","maximum":10,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"On `textIntro`/`textOutro` only: which units play the side, each in turn. Required on a new text side.","required":["unit"],"properties":{"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"},"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000). Defaults to 100.","maximum":2000,"minimum":0,"type":"number","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"number"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time. Defaults to `forward`.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units. Defaults to `linear`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","uniqueKey":"keystrokes.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"keystrokes.animation.textOutro.oneOf.1","typeLabel":"null"}],"uniqueKey":"keystrokes.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"keystrokes.animation","typeLabel":"object"},"colors":{"additionalProperties":false,"properties":{"background":{"description":"The container behind the keys.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"keystrokes.colors.background","typeLabel":"string"},"keyBackground":{"description":"Each key's cap (or the pill).","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"keystrokes.colors.keyBackground","typeLabel":"string"},"keyText":{"description":"The key labels.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"keystrokes.colors.keyText","typeLabel":"string"}},"type":"object","uniqueKey":"keystrokes.colors","typeLabel":"object"},"displayDurationMs":{"description":"How long a chord lingers after its key is released, in milliseconds.","example":1000,"maximum":10000,"minimum":300,"type":"integer","uniqueKey":"keystrokes.displayDurationMs","typeLabel":"integer"},"enabled":{"description":"Show the HUD.","example":true,"type":"boolean","uniqueKey":"keystrokes.enabled","typeLabel":"boolean"},"filter":{"description":"`shortcuts` shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; `all` also shows plain typing, including any text typed while recording.","enum":["shortcuts","all"],"example":"shortcuts","type":"string","uniqueKey":"keystrokes.filter","typeLabel":"enum\u003cstring>"},"labels":{"description":"The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. `both` shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).","enum":["mac","windows","both"],"type":"string","uniqueKey":"keystrokes.labels","typeLabel":"enum\u003cstring>"},"position":{"additionalProperties":false,"properties":{"x":{"description":"0 is the left edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"keystrokes.position.x","typeLabel":"number"},"y":{"description":"0 is the top edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"keystrokes.position.y","typeLabel":"number"}},"required":["x","y"],"type":"object","uniqueKey":"keystrokes.position","typeLabel":"object"},"size":{"description":"Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).","example":1,"maximum":4,"minimum":0.5,"type":"number","uniqueKey":"keystrokes.size","typeLabel":"number"},"style":{"description":"`keycap` draws one rounded cap per key in a container; `pill` draws the chord as text in one box.","enum":["keycap","pill"],"example":"keycap","type":"string","uniqueKey":"keystrokes.style","typeLabel":"enum\u003cstring>"},"typing":{"description":"How `filter: all` shows plain typing. `keys` (the default when absent) shows one key per press; `words` grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.","enum":["keys","words"],"example":"words","type":"string","uniqueKey":"keystrokes.typing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"keystrokes","typeLabel":"object"},"layoutAnimationStyle":{"description":"How layout transitions animate, gentlest to snappiest. Changing it leaves zooms as they were: when zooms have no `zoomAnimationStyle` of their own, they keep the previous style.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest"],"example":"snappy","type":"string","uniqueKey":"layoutAnimationStyle","typeLabel":"enum\u003cstring>"},"linkScope":{"description":"Access level: public (anyone with link), private (org members only), password (requires password), embedonly (only viewable when embedded)","enum":["public","private","password","embedonly"],"example":"public","type":"string","uniqueKey":"linkScope","typeLabel":"enum\u003cstring>"},"microphoneVolume":{"description":"Volume of the microphone (webcam) audio across the whole video. 1 is the recorded level, 0 mutes it, 2 doubles it. Clips that set their own `microphoneVolume` keep it — change or clear those with `PATCH /v1/videos/{id}/clips/{clipId}`.","example":1.2,"maximum":2,"minimum":0,"type":"number","uniqueKey":"microphoneVolume","typeLabel":"number"},"motionBlur":{"description":"Blur fast zoom, pan, and cursor movement. Defaults on for new videos.","example":true,"type":"boolean","uniqueKey":"motionBlur","typeLabel":"boolean"},"motionBlurAmount":{"description":"Motion blur strength, the editor's Motion blur slider: 0.1 (subtle) to 2 (strong), 1 is the default. Setting it turns motion blur on, so it can't be combined with `motionBlur: false`.","example":1.3,"maximum":2,"minimum":0.1,"type":"number","uniqueKey":"motionBlurAmount","typeLabel":"number"},"name":{"description":"Video title","example":"Updated Video Title","maxLength":255,"minLength":1,"type":"string","uniqueKey":"name","typeLabel":"string"},"password":{"description":"Password for viewing. Required when linkScope is 'password', ignored otherwise.","example":"secretpassword","maxLength":255,"minLength":1,"type":"string","uniqueKey":"password","typeLabel":"string"},"publishDateEnabled":{"description":"Show publish date on video page","example":true,"type":"boolean","uniqueKey":"publishDateEnabled","typeLabel":"boolean"},"rawDownloadsEnabled":{"description":"Allow viewers to download raw source files","example":false,"type":"boolean","uniqueKey":"rawDownloadsEnabled","typeLabel":"boolean"},"searchEngineIndexingEnabled":{"description":"Allow search engines to index the video page","example":true,"type":"boolean","uniqueKey":"searchEngineIndexingEnabled","typeLabel":"boolean"},"shrinkCameraDuringZooms":{"description":"Shrink camera bubbles while a zoom is active. Defaults on.","example":true,"type":"boolean","uniqueKey":"shrinkCameraDuringZooms","typeLabel":"boolean"},"sourceId":{"description":"Source ID from POST /v1/sources (kind: 'video'). Upload the video bytes to the source's uploadUrl first; the source becomes the new video's first clip. Leave it out for an empty video, as the editor's New video makes: add clips with POST /v1/videos/{id}/clips or POST /v1/motion/clips.","example":"su_abc123def456","minLength":1,"type":"string","uniqueKey":"sourceId","typeLabel":"string"},"studioSound":{"description":"Studio Sound (AI audio enhancement) master switch. Enabling it also starts generating the enhanced audio tracks in the background; playback and exports use them once ready and fall back to the raw audio until then.","example":true,"type":"boolean","uniqueKey":"studioSound","typeLabel":"boolean"},"studioSoundLevel":{"description":"Studio Sound level, as in the editor's Studio Voice panel. `low` and `high` turn Studio Sound on at that strength and regenerate the enhanced audio tracks when the level changes; `off` turns it off. Pass this or `studioSound`, or both when they agree.","enum":["off","low","high"],"example":"low","type":"string","uniqueKey":"studioSoundLevel","typeLabel":"enum\u003cstring>"},"subtitlesEnabled":{"description":"Allow viewers to enable subtitles","example":true,"type":"boolean","uniqueKey":"subtitlesEnabled","typeLabel":"boolean"},"systemAudioVolume":{"description":"Volume of the system/screen audio across the whole video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. Clips that set their own `systemAudioVolume` keep it — change or clear those with `PATCH /v1/videos/{id}/clips/{clipId}`.","example":0.4,"maximum":2,"minimum":0,"type":"number","uniqueKey":"systemAudioVolume","typeLabel":"number"},"transcriptsEnabled":{"description":"Show transcript panel to viewers","example":true,"type":"boolean","uniqueKey":"transcriptsEnabled","typeLabel":"boolean"},"viewCountEnabled":{"description":"Show view count on video page","example":true,"type":"boolean","uniqueKey":"viewCountEnabled","typeLabel":"boolean"},"zoomAnimationStyle":{"description":"How zooms ease in, out, and between each other, gentlest to snappiest. Independent of `layoutAnimationStyle`.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest"],"example":"brisk","type":"string","uniqueKey":"zoomAnimationStyle","typeLabel":"enum\u003cstring>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"allowedEmbedDomains":["example.com","mysite.org"],"autoRatio":true,"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","backgroundBorderColor":"#5E51F8FF","backgroundBorderEnabled":true,"backgroundBorderWidth":0.25,"backgroundEnabled":true,"backgroundPadding":0.5,"backgroundRadius":1,"highlightColor":"#5E51F8FF","maxWidth":0.65,"outlineColor":"#5E51F8FF","outlineEnabled":true,"outlineWidth":0.25,"shadowColor":"#5E51F8FF","shadowEnabled":true},"captionsDefaultEnabled":true,"commentEmailsEnabled":false,"commentsEnabled":true,"creatorEnabled":true,"cursor":{"clickRipple":false,"hideWhenInactive":false,"returnToStart":false,"size":3.05,"smoothing":false,"style":"macTahoe","tilt":false,"tiltStrength":0.5},"customThumbnailURL":"https://example.com/custom-thumbnail.jpg","defaultClipTransition":"hard_cut","defaultPlaybackRate":1,"description":"Updated description for the video","dimensions":{"height":1920,"width":1080},"documentGenerationEnabled":true,"downloadsEnabled":true,"eyeContact":true,"keystrokes":{"alignment":"center","animation":{"intro":{"preset":"slide_up"},"outro":{"preset":"fade"}},"colors":{"background":"#FFFFFF","keyBackground":"#FFFFFF","keyText":"#FFFFFF"},"displayDurationMs":1000,"enabled":true,"filter":"shortcuts","size":1,"style":"keycap","typing":"words"},"layoutAnimationStyle":"snappy","linkScope":"public","microphoneVolume":1.2,"motionBlur":true,"motionBlurAmount":1.3,"name":"Updated Video Title","password":"secretpassword","publishDateEnabled":true,"rawDownloadsEnabled":false,"searchEngineIndexingEnabled":true,"shrinkCameraDuringZooms":true,"sourceId":"su_abc123def456","studioSound":true,"studioSoundLevel":"low","subtitlesEnabled":true,"systemAudioVolume":0.4,"transcriptsEnabled":true,"viewCountEnabled":true,"zoomAnimationStyle":"brisk"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"fec9b987-931d-45e7-9850-1a10bff605d2":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"video":{"additionalProperties":false,"description":"Detailed information about a video including chapters, transcript, and exports","properties":{"aspectRatio":{"description":"Video aspect ratio (e.g., '16:9', '9:16')","example":"16:9","type":"string","isRequired":true,"uniqueKey":"video.aspectRatio","typeLabel":"string"},"autoRatio":{"description":"Whether the canvas is in Auto ratio (sized from the video's recording and following it as layouts change), the editor's canvas size menu → Auto.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.autoRatio","typeLabel":"boolean"},"backgroundMusic":{"oneOf":[{"type":"object","description":"Video-wide track that loops over the whole video and is included in exports","required":["url","durationMs","volume","name"],"properties":{"durationMs":{"description":"Audio track duration in milliseconds","example":180036,"exclusiveMinimum":true,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.durationMs","typeLabel":"number"},"name":{"oneOf":[{"description":"Optional display name for the track","example":"Calm Product Tour","type":"string","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.name.oneOf.0","typeLabel":"string"},{"description":"Optional display name for the track","example":"Calm Product Tour","type":"null","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.name","typeLabel":"string | null"},"url":{"description":"HTTPS URL of the audio track","example":"https://ucarecdn.com/example-track/","format":"uri","pattern":"^https:\\/\\/.*","type":"string","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.url","typeLabel":"string\u003curi>"},"volume":{"description":"Track volume from 0 (silent) to 1 (full volume)","example":0.2,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0.volume","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.backgroundMusic.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.backgroundMusic","typeLabel":"object | null"},"chapters":{"description":"Video chapters/sections","items":{"additionalProperties":false,"description":"A chapter/section within a video","properties":{"description":{"description":"Chapter description","example":"Overview of what we'll cover","maxLength":5000,"type":"string","isRequired":true,"uniqueKey":"video.chapters.items.[INDEX].description","typeLabel":"string"},"timestampSeconds":{"description":"Chapter start time in seconds","example":0,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.chapters.items.[INDEX].timestampSeconds","typeLabel":"number"},"title":{"description":"Chapter title","example":"Introduction","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.chapters.items.[INDEX].title","typeLabel":"string"}},"required":["title","description","timestampSeconds"],"type":"object","uniqueKey":"video.chapters.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"video.chapters","typeLabel":"object[]"},"clipIds":{"description":"Ordered IDs of the clips in the video. Use `/v1/videos/{id}/clips/{clipId}` to fetch each one.","example":["cl_abc123","cl_def456"],"items":{"type":"string","uniqueKey":"video.clipIds.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"video.clipIds","typeLabel":"string[]"},"createdAt":{"description":"ISO 8601 datetime","example":"2024-01-15T10:30:00.000Z","format":"date-time","type":"string","isRequired":true,"uniqueKey":"video.createdAt","typeLabel":"string\u003cdate-time>"},"description":{"description":"Video description","example":"Learn how to create and share your first video","maxLength":5000,"type":"string","isRequired":true,"uniqueKey":"video.description","typeLabel":"string"},"dimensions":{"additionalProperties":false,"description":"Canvas size in pixels","example":{"height":1080,"width":1920},"properties":{"height":{"type":"number","isRequired":true,"uniqueKey":"video.dimensions.height","typeLabel":"number"},"width":{"type":"number","isRequired":true,"uniqueKey":"video.dimensions.width","typeLabel":"number"}},"required":["width","height"],"type":"object","isRequired":true,"uniqueKey":"video.dimensions","typeLabel":"object"},"durationSeconds":{"description":"Video duration in seconds","example":125.5,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.durationSeconds","typeLabel":"number"},"exports":{"description":"Available exports and their status","items":{"additionalProperties":false,"description":"Status of a video export job","properties":{"downloadUrl":{"oneOf":[{"description":"Download URL when export is completed, null otherwise","example":"https://cdn.tella.tv/exports/vid_abc123/video.mp4","format":"uri","type":"string","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].downloadUrl.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Download URL when export is completed, null otherwise","example":"https://cdn.tella.tv/exports/vid_abc123/video.mp4","format":"uri","type":"null","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].downloadUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.exports.items.[INDEX].downloadUrl","typeLabel":"string\u003curi> | null"},"exportId":{"description":"Unique identifier for the export job","example":"Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS","type":"string","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].exportId","typeLabel":"string"},"progress":{"oneOf":[{"description":"Export progress percentage (0-100), null if not started","example":100,"maximum":100,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].progress.oneOf.0","typeLabel":"number"},{"description":"Export progress percentage (0-100), null if not started","example":100,"maximum":100,"minimum":0,"type":"null","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].progress.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.exports.items.[INDEX].progress","typeLabel":"number | null"},"status":{"description":"Current export status","enum":["queued","running","completed","failed"],"example":"completed","type":"string","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"updatedAt":{"description":"ISO 8601 datetime of last status update","example":"2024-01-15T15:00:00.000Z","format":"date-time","type":"string","isRequired":true,"uniqueKey":"video.exports.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"}},"required":["exportId","status","progress","downloadUrl","updatedAt"],"type":"object","uniqueKey":"video.exports.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"video.exports","typeLabel":"object[]"},"id":{"description":"Unique video identifier","example":"vid_abc123def456","type":"string","isRequired":true,"uniqueKey":"video.id","typeLabel":"string"},"links":{"type":"object","description":"Related URLs for the video","required":["viewPage","embedPage"],"properties":{"embedPage":{"description":"URL for embedding the video","example":"https://www.tella.tv/video/vid_abc123def456/embed","format":"uri","type":"string","isRequired":true,"uniqueKey":"video.links.embedPage","typeLabel":"string\u003curi>"},"viewPage":{"description":"URL to view the video on Tella","example":"https://www.tella.tv/video/vid_abc123def456/view","format":"uri","type":"string","isRequired":true,"uniqueKey":"video.links.viewPage","typeLabel":"string\u003curi>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.links","typeLabel":"object"},"name":{"description":"Video title","example":"Getting Started with Tella","maxLength":255,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.name","typeLabel":"string"},"playlistIds":{"description":"IDs of playlists containing this video","example":["pl_abc123","pl_def456"],"items":{"type":"string","uniqueKey":"video.playlistIds.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"video.playlistIds","typeLabel":"string[]"},"settings":{"type":"object","description":"Video playback and access settings","required":["defaultPlaybackRate","captionsDefaultEnabled","subtitlesEnabled","captionStyle","captionSize","captionGrouping","captionPosition","captionFontFamily","captionFontWeight","captionFontSize","captionLinesPerBlock","transcriptsEnabled","documentGenerationEnabled","creatorEnabled","publishDateEnabled","viewCountEnabled","commentsEnabled","commentEmailsEnabled","downloadsEnabled","rawDownloadsEnabled","linkScope","searchEngineIndexingEnabled","allowedEmbedDomains","customThumbnailURL","thumbnailInpointMs","studioSound","studioSoundLevel","defaultClipTransition","microphoneVolume","systemAudioVolume","motionBlur","shrinkCameraDuringZooms","layoutAnimationStyle","zoomAnimationStyle","cursor","callToAction","secondaryCallToAction","workspaceCallToAction","workspaceSecondaryCallToAction","callToActionsHidden"],"properties":{"allowedEmbedDomains":{"description":"Restrict embedding to these domains only (Premium feature). Empty array allows all domains.","example":["example.com","mysite.org"],"items":{"type":"string","uniqueKey":"video.settings.allowedEmbedDomains.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"video.settings.allowedEmbedDomains","typeLabel":"string[]"},"callToAction":{"oneOf":[{"type":"object","description":"The video's own call-to-action button on its share page. null when it has none, in which case `workspaceCallToAction` shows instead.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.settings.callToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"video.settings.callToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.callToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.callToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.callToAction","typeLabel":"object | null"},"callToActionsHidden":{"description":"Every call-to-action button is hidden on the share page, the workspace defaults included.","type":"boolean","isRequired":true,"uniqueKey":"video.settings.callToActionsHidden","typeLabel":"boolean"},"captionFontFamily":{"description":"Subtitle font family. On write, one of Tella's catalog font families or the built-in subtitle families `Dela Gothic One`, `Lato`, `Georgia`, and `Arial`, or the video's current family to keep an uploaded font. Reads report the family the subtitles render with.","example":"Inter","minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.settings.captionFontFamily","typeLabel":"string"},"captionFontSize":{"description":"Exact subtitle text size, 40 to 200 — the editor's Size slider. `captionSize` is the same setting in buckets (small 40, medium 64, large 80), so a request passes one or the other, not both.","example":64,"maximum":200,"minimum":40,"type":"number","isRequired":true,"uniqueKey":"video.settings.captionFontSize","typeLabel":"number"},"captionFontWeight":{"description":"Subtitle font weight, 100 (thin) to 1000. Catalog fonts clamp to their supported range; built-in subtitle fonts outside the catalog snap to an available weight. `Dela Gothic One` uses 400 only; `Arial` uses 400 or 700. Reads report the weight that renders. Sent without `captionFontFamily`, it re-weights the video's current font.","example":500,"maximum":1000,"minimum":100,"type":"number","isRequired":true,"uniqueKey":"video.settings.captionFontWeight","typeLabel":"number"},"captionGrouping":{"description":"How subtitle text is grouped: sentence chunks or one word at a time.","enum":["chunked","singleWord"],"example":"chunked","type":"string","isRequired":true,"uniqueKey":"video.settings.captionGrouping","typeLabel":"enum\u003cstring>"},"captionLinesPerBlock":{"description":"Lines a caption block may span when `captionGrouping` is `chunked`: 1, 2, or 3, or 0 for no limit, where blocks only break on pauses and sentence ends.","example":1,"maximum":3,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.captionLinesPerBlock","typeLabel":"integer"},"captionPosition":{"oneOf":[{"type":"object","description":"Normalized subtitle position, or null for automatic placement. Applies if subtitles are enabled on the video.","required":["x","y"],"properties":{"x":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.captionPosition.oneOf.0.x","typeLabel":"number"},"y":{"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.captionPosition.oneOf.0.y","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionPosition.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.captionPosition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.captionPosition","typeLabel":"object | null"},"captionSize":{"description":"Subtitle text size. Applies if subtitles are enabled on the video.","enum":["small","medium","large"],"example":"medium","type":"string","isRequired":true,"uniqueKey":"video.settings.captionSize","typeLabel":"enum\u003cstring>"},"captionStyle":{"oneOf":[{"type":"object","title":"Backdrop","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["backgroundColor","name","textColor","wordLevelHighlights"],"properties":{"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundColor","typeLabel":"string"},"name":{"enum":["backdrop"],"type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.0.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.0.textColor","typeLabel":"string"},"wordLevelHighlights":{"type":"boolean","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.0.wordLevelHighlights","typeLabel":"boolean"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundBorderWidth","typeLabel":"number"},"backgroundEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.0.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Omit to retain the legacy text-opacity progression.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.0.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.0.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.0.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.0.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.0.textCase","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.0","typeLabel":"Backdrop · object"},{"type":"object","title":"Highlight","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","primaryTextColor","secondaryTextColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.1.highlightColor","typeLabel":"string"},"name":{"enum":["highlight"],"type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.1.name","typeLabel":"enum\u003cstring>"},"primaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.1.primaryTextColor","typeLabel":"string"},"secondaryTextColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.1.secondaryTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.1.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to background.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.1.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.1.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.1.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.1.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.1.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.1.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.1","typeLabel":"Highlight · object"},{"type":"object","title":"Mono","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["name","textColor","highlightColor"],"properties":{"highlightColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.2.highlightColor","typeLabel":"string"},"name":{"enum":["mono"],"type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.2.name","typeLabel":"enum\u003cstring>"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.2.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.2.backgroundRadius","typeLabel":"number"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.2.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.2.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.2.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.2.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.2.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to true.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.2.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.2","typeLabel":"Mono · object"},{"type":"object","title":"Cannes","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["shadowColor","name","textColor"],"properties":{"name":{"enum":["cannes"],"type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.3.name","typeLabel":"enum\u003cstring>"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.3.shadowColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.3.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.3.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.3.maxWidth","typeLabel":"number"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.outlineColor","typeLabel":"string"},"outlineEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.3.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.3.outlineWidth","typeLabel":"number"},"shadowEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.3.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.3.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.3.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.3","typeLabel":"Cannes · object"},{"type":"object","title":"Classic","description":"Subtitle style. Applies if subtitles are enabled on the video. Background, shadow, and outline colors and toggles are available on every style.","required":["outlineColor","name","textColor"],"properties":{"name":{"enum":["classic"],"type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.4.name","typeLabel":"enum\u003cstring>"},"outlineColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.4.outlineColor","typeLabel":"string"},"textColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.4.textColor","typeLabel":"string"},"activeWordTextColor":{"description":"Text color of the spoken word when highlightMode is background. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.activeWordTextColor","typeLabel":"string"},"backgroundBorderColor":{"description":"Color of the background border in #RRGGBB or #RRGGBBAA form. Defaults to white.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundBorderColor","typeLabel":"string"},"backgroundBorderEnabled":{"description":"Whether a border is drawn around the caption background. Defaults to false. No effect while backgroundEnabled is false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundBorderEnabled","typeLabel":"boolean"},"backgroundBorderWidth":{"description":"Thickness of the background border, as a fraction of the font size. Defaults to 0.06.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundBorderWidth","typeLabel":"number"},"backgroundColor":{"description":"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.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundColor","typeLabel":"string"},"backgroundEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundEnabled","typeLabel":"boolean"},"backgroundPadding":{"description":"Extra room around the caption text inside its background, as a fraction of the font size added on every side. Defaults to 0, the style's standard padding. No effect while backgroundEnabled is false.","maximum":1,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundPadding","typeLabel":"number"},"backgroundRadius":{"description":"Corner radius of the caption background, as a fraction of the font size; large values make a pill. Defaults to the style's own rounding (0.5 for backdrop, 0.3 for the others), which responses report. No effect while backgroundEnabled is false.","maximum":2,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.4.backgroundRadius","typeLabel":"number"},"highlightColor":{"description":"Spoken-word color. Defaults to textColor.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.highlightColor","typeLabel":"string"},"highlightMode":{"description":"How the spoken word is emphasized. Defaults to text.","enum":["text","background","fadeRest"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.highlightMode","typeLabel":"enum\u003cstring>"},"maxWidth":{"description":"Widest the caption box may be, as a fraction of the video's width. Longer captions wrap and hold fewer words. Defaults to 1 (no limit).","maximum":1,"minimum":0.3,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.4.maxWidth","typeLabel":"number"},"outlineEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.4.outlineEnabled","typeLabel":"boolean"},"outlineWidth":{"description":"Thickness of the text outline, as a fraction of the font size. Defaults to 0.125. No effect while outlineEnabled is false.","maximum":0.5,"minimum":0,"type":"number","uniqueKey":"video.settings.captionStyle.oneOf.4.outlineWidth","typeLabel":"number"},"shadowColor":{"description":"Hex color in #RRGGBB or #RRGGBBAA form. Responses use uppercase #RRGGBBAA.","example":"#5E51F8FF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.shadowColor","typeLabel":"string"},"shadowEnabled":{"type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.4.shadowEnabled","typeLabel":"boolean"},"textCase":{"description":"Letter case applied to every caption word. Defaults to original.","enum":["original","uppercase","lowercase"],"type":"string","uniqueKey":"video.settings.captionStyle.oneOf.4.textCase","typeLabel":"enum\u003cstring>"},"wordLevelHighlights":{"description":"Highlight each word as it is spoken. Defaults to false.","type":"boolean","uniqueKey":"video.settings.captionStyle.oneOf.4.wordLevelHighlights","typeLabel":"boolean"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.captionStyle.oneOf.4","typeLabel":"Classic · object"}],"isRequired":true,"uniqueKey":"video.settings.captionStyle","typeLabel":"Backdrop · object | Highlight · object | Mono · object | Cannes · object | Classic · object"},"captionsDefaultEnabled":{"description":"Show subtitles to viewers by default","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.captionsDefaultEnabled","typeLabel":"boolean"},"commentEmailsEnabled":{"description":"Send email notifications for new comments","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.commentEmailsEnabled","typeLabel":"boolean"},"commentsEnabled":{"description":"Allow viewers to comment","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.commentsEnabled","typeLabel":"boolean"},"creatorEnabled":{"description":"Show who created the video on the video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.creatorEnabled","typeLabel":"boolean"},"cursor":{"additionalProperties":false,"description":"Animated cursor settings","properties":{"clickRipple":{"description":"Show a ripple on mouse clicks. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.cursor.clickRipple","typeLabel":"boolean"},"hideWhenInactive":{"description":"Fade the animated cursor out while inactive and back in when activity resumes.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.cursor.hideWhenInactive","typeLabel":"boolean"},"returnToStart":{"description":"Move the cursor back to its opening position at the end for cleaner loops.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.cursor.returnToStart","typeLabel":"boolean"},"size":{"description":"Animated cursor size multiplier.","example":3.05,"maximum":6,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.cursor.size","typeLabel":"number"},"smoothing":{"description":"Smooth cursor movement. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.cursor.smoothing","typeLabel":"boolean"},"style":{"description":"Animated cursor artwork. mac is the pre-Tahoe style; macTahoe and macGoldenGate match those macOS generations; windows and touch use platform-specific artwork.","enum":["mac","macTahoe","macGoldenGate","windows","touch"],"example":"macTahoe","type":"string","isRequired":true,"uniqueKey":"video.settings.cursor.style","typeLabel":"enum\u003cstring>"},"tilt":{"description":"Tilt the cursor in the direction it moves. Defaults off for new videos.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.cursor.tilt","typeLabel":"boolean"},"tiltStrength":{"description":"How far the cursor tilts while moving, from 0 (none) to 2 (maximum). Defaults to 0.5 for new videos. Only has an effect when tilt is true.","example":0.5,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.cursor.tiltStrength","typeLabel":"number"}},"required":["style","size","smoothing","tilt","tiltStrength","clickRipple","hideWhenInactive","returnToStart"],"type":"object","isRequired":true,"uniqueKey":"video.settings.cursor","typeLabel":"object"},"customThumbnailURL":{"oneOf":[{"description":"Custom thumbnail image URL","example":"https://example.com/custom-thumbnail.jpg","format":"uri","type":"string","isRequired":true,"uniqueKey":"video.settings.customThumbnailURL.oneOf.0","typeLabel":"string\u003curi>"},{"description":"Custom thumbnail image URL","example":"https://example.com/custom-thumbnail.jpg","format":"uri","type":"null","isRequired":true,"uniqueKey":"video.settings.customThumbnailURL.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.customThumbnailURL","typeLabel":"string\u003curi> | null"},"defaultClipTransition":{"type":"string","description":"How each clip enters from the previous one, unless the clip overrides it via its own `transition`.","enum":["smooth","hard_cut"],"example":"hard_cut","isRequired":true,"uniqueKey":"video.settings.defaultClipTransition","typeLabel":"enum\u003cstring>"},"defaultPlaybackRate":{"description":"Default playback speed (0.5-2.0). Viewers can still adjust.","example":1,"maximum":2,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.defaultPlaybackRate","typeLabel":"number"},"documentGenerationEnabled":{"description":"Allow viewers to generate documents from the video (the Ask tab and POST /v1/videos/{id}/documents)","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.documentGenerationEnabled","typeLabel":"boolean"},"downloadsEnabled":{"description":"Allow viewers to download the video","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.downloadsEnabled","typeLabel":"boolean"},"layoutAnimationStyle":{"description":"How layout transitions animate, gentlest to snappiest. Zooms have their own `zoomAnimationStyle`. `custom` is a spring set outside the named styles.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest","custom"],"example":"moderate","type":"string","isRequired":true,"uniqueKey":"video.settings.layoutAnimationStyle","typeLabel":"enum\u003cstring>"},"linkScope":{"type":"string","description":"Current access level, including `org` for workspace-visible videos","enum":["public","private","org","password","embedonly"],"example":"org","isRequired":true,"uniqueKey":"video.settings.linkScope","typeLabel":"enum\u003cstring>"},"microphoneVolume":{"description":"Volume of the microphone (webcam) audio across the video. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.","example":1,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.microphoneVolume","typeLabel":"number"},"motionBlur":{"description":"Blur fast zoom, pan, and cursor movement. Defaults on for new videos.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.motionBlur","typeLabel":"boolean"},"publishDateEnabled":{"description":"Show publish date on video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.publishDateEnabled","typeLabel":"boolean"},"rawDownloadsEnabled":{"description":"Allow viewers to download raw source files","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.rawDownloadsEnabled","typeLabel":"boolean"},"searchEngineIndexingEnabled":{"description":"Allow search engines to index the video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.searchEngineIndexingEnabled","typeLabel":"boolean"},"secondaryCallToAction":{"oneOf":[{"type":"object","description":"The video's own second button, next to `callToAction`. null when it has none, in which case `workspaceSecondaryCallToAction` shows instead.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.settings.secondaryCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"video.settings.secondaryCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.secondaryCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.secondaryCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.secondaryCallToAction","typeLabel":"object | null"},"shrinkCameraDuringZooms":{"description":"Shrink camera bubbles while a zoom is active. Defaults on.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.shrinkCameraDuringZooms","typeLabel":"boolean"},"studioSound":{"description":"Studio Sound (AI audio enhancement) master switch for the video. Individual clips can opt out via the clip's `studioSound` field.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.studioSound","typeLabel":"boolean"},"studioSoundLevel":{"description":"Studio Sound level, as in the editor's Studio Voice panel: `off`, `low` or `high`.","enum":["off","low","high"],"example":"off","type":"string","isRequired":true,"uniqueKey":"video.settings.studioSoundLevel","typeLabel":"enum\u003cstring>"},"subtitlesEnabled":{"description":"Allow viewers to enable subtitles","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.subtitlesEnabled","typeLabel":"boolean"},"systemAudioVolume":{"description":"Volume of the system/screen audio across the video — everything that is not microphone audio. 1 is the recorded level, 0 mutes it, 2 doubles it. A clip can override it for one of its sources.","example":1,"maximum":2,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.systemAudioVolume","typeLabel":"number"},"thumbnailInpointMs":{"oneOf":[{"description":"Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via `inpointMs`). Null when the thumbnail is an uploaded image or the default. A picked frame leaves `customThumbnailURL` null, so check this field to verify it.","example":12000,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.thumbnailInpointMs.oneOf.0","typeLabel":"integer"},{"description":"Time in ms on the video's playback timeline of the frame picked as the thumbnail (set via `inpointMs`). Null when the thumbnail is an uploaded image or the default. A picked frame leaves `customThumbnailURL` null, so check this field to verify it.","example":12000,"maximum":9007199254740991,"minimum":0,"type":"null","isRequired":true,"uniqueKey":"video.settings.thumbnailInpointMs.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.thumbnailInpointMs","typeLabel":"integer | null"},"transcriptsEnabled":{"description":"Show transcript panel to viewers","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.transcriptsEnabled","typeLabel":"boolean"},"viewCountEnabled":{"description":"Show view count on video page","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.viewCountEnabled","typeLabel":"boolean"},"workspaceCallToAction":{"oneOf":[{"type":"object","description":"The workspace's default button (Settings → CTA button), shown when the video has no `callToAction` of its own. Read-only here.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.settings.workspaceCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"video.settings.workspaceCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.workspaceCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.workspaceCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.workspaceCallToAction","typeLabel":"object | null"},"workspaceSecondaryCallToAction":{"oneOf":[{"type":"object","description":"The workspace's default second button, shown when the video has no `secondaryCallToAction` of its own. Read-only here.","required":["label","url"],"properties":{"label":{"description":"Button text","maxLength":100,"minLength":1,"type":"string","isRequired":true,"uniqueKey":"video.settings.workspaceSecondaryCallToAction.oneOf.0.label","typeLabel":"string"},"url":{"description":"Where the button links, starting https:// or http://","example":"https://docs.tella.com/help","type":"string","isRequired":true,"uniqueKey":"video.settings.workspaceSecondaryCallToAction.oneOf.0.url","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.workspaceSecondaryCallToAction.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.workspaceSecondaryCallToAction.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.workspaceSecondaryCallToAction","typeLabel":"object | null"},"zoomAnimationStyle":{"description":"How zooms ease in, out, and between each other, gentlest to snappiest. Zooms follow `layoutAnimationStyle` until one is set. `custom` is a spring set outside the named styles.","enum":["gentlest","gentle","relaxed","smooth","moderate","brisk","focused","snappy","punchy","snappiest","custom"],"example":"moderate","type":"string","isRequired":true,"uniqueKey":"video.settings.zoomAnimationStyle","typeLabel":"enum\u003cstring>"},"eyeContact":{"type":"object","description":"Eye contact correction: AI redirects the speaker's gaze to the camera lens in every camera recording. Only returned to callers who can edit the video, on the video itself (not the timeline).","required":["enabled","status","cameras","camerasReady"],"properties":{"cameras":{"description":"Camera recordings in the video. Screen recordings and uploaded videos are never changed.","example":1,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.eyeContact.cameras","typeLabel":"integer"},"camerasReady":{"description":"Camera recordings that have their corrected version","example":1,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.eyeContact.camerasReady","typeLabel":"integer"},"enabled":{"description":"Whether eye contact correction is on for the video","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.eyeContact.enabled","typeLabel":"boolean"},"status":{"description":"`processing` while the last switch is being applied (cameras are being prepared, or it is turning off); `ready` once every camera has its corrected version; `failed` when it is on but some cameras couldn't be prepared (those keep their original look); `off` when it is off.","enum":["off","processing","ready","failed"],"example":"ready","type":"string","isRequired":true,"uniqueKey":"video.settings.eyeContact.status","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.eyeContact","typeLabel":"object"},"keystrokes":{"type":"object","description":"The keystroke HUD, once someone has configured it on the video.","required":["enabled","filter","style","size","displayDurationMs","animation","colors","position","alignment"],"properties":{"alignment":{"description":"Which horizontal edge of the HUD sits on position.x.","enum":["left","center","right"],"example":"center","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.alignment","typeLabel":"enum\u003cstring>"},"animation":{"type":"object","description":"How each chord enters and leaves. The text sides are always null.","required":["intro","outro","textIntro","textOutro","motionBlur"],"properties":{"intro":{"oneOf":[{"type":"object","description":"How the whole overlay enters, or null when it appears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.intro","typeLabel":"object | null"},"motionBlur":{"description":"Blur the overlay along its motion while it moves, scales or turns.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.motionBlur","typeLabel":"boolean"},"outro":{"oneOf":[{"type":"object","description":"How the whole overlay leaves, or null when it disappears instantly.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.outro","typeLabel":"object | null"},"textIntro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines enter, one after another, while `intro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textIntro","typeLabel":"object | null"},"textOutro":{"oneOf":[{"type":"object","description":"How a text overlay's letters, words or lines leave, one after another, while `outro` plays on the whole box. Null when they don't.","required":["preset","moveX","moveY","rotate","scale","opacity","blur","clip","durationMs","easing"],"properties":{"blur":{"description":"Blur of the hidden state in pixels.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.blur","typeLabel":"number"},"clip":{"description":"Clip the motion to the overlay's box, so it wipes in like a mask.","example":false,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.clip","typeLabel":"boolean"},"durationMs":{"description":"How long the side plays, in ms (50 to 5000). On a text side, how long each unit plays.","example":500,"maximum":9007199254740991,"minimum":-9007199254740991,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.durationMs","typeLabel":"integer"},"easing":{"additionalProperties":false,"properties":{"curve":{"description":"How a side accelerates. `linear` keeps one speed. `smooth`, `natural`, `slow_down`, `accelerate`, `elastic`, `bounce`, `overshoot`, `impulse` and `swing` are shaped by `intensity`. `custom` follows `bezier`, `spring` follows `spring`.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","bounce","overshoot","impulse","swing","custom","spring"],"example":"slow_down","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.curve","typeLabel":"enum\u003cstring>"},"intensity":{"description":"How strongly the curve shapes the motion, 0 to 1. Only curves with an intensity use it.","example":0.5,"maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.intensity","typeLabel":"number"},"bezier":{"description":"The `custom` curve's handles.","example":[0.25,0.1,0.25,1],"items":{"oneOf":[{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.0","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.1","typeLabel":"number"},{"type":"number","maximum":1,"minimum":0,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.2","typeLabel":"number"},{"type":"number","uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX].oneOf.3","typeLabel":"number"}],"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier.items.[INDEX]","typeLabel":"number"},"maxItems":4,"minItems":4,"type":"array","uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.bezier","typeLabel":"number[]"},"spring":{"type":"object","description":"The `spring` curve's physics.","required":["stiffness","damping","mass"],"properties":{"damping":{"example":12,"maximum":300,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.damping","typeLabel":"number"},"mass":{"example":1,"maximum":10,"minimum":0.1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.mass","typeLabel":"number"},"stiffness":{"example":200,"maximum":1000,"minimum":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring.stiffness","typeLabel":"number"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing.spring","typeLabel":"object"}},"required":["curve","intensity"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.easing","typeLabel":"object"},"moveX":{"description":"Horizontal offset of the hidden state, as a fraction of the overlay's width (of a line's height on a text side); positive is right.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.moveX","typeLabel":"number"},"moveY":{"description":"Vertical offset of the hidden state, as a fraction of the overlay's height (of a line's height on a text side); positive is down.","example":-0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.moveY","typeLabel":"number"},"opacity":{"description":"Opacity of the hidden state, 0 to 1.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.opacity","typeLabel":"number"},"preset":{"oneOf":[{"type":"string","description":"The preset the side matches, or null once its motion is custom.","enum":["fade","slide_up","slide_down","slide_left","slide_right","mask_up","mask_down","grow","shrink","blur","blur_slide_up"],"example":"slide_up","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.preset.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.preset.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.preset","typeLabel":"enum\u003cstring> | null"},"rotate":{"description":"Clockwise rotation of the hidden state in degrees.","example":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.rotate","typeLabel":"number"},"scale":{"description":"Scale of the hidden state; 1 is its resting size.","example":1,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.scale","typeLabel":"number"},"text":{"type":"object","description":"The units a text side plays on, each in turn.","required":["unit","order","delayMs","smoothing"],"properties":{"delayMs":{"description":"How long after one unit the next starts, in ms (0 to 2000).","example":100,"maximum":2000,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.text.delayMs","typeLabel":"integer"},"order":{"description":"Which unit goes first. `random` uses the same shuffle every time.","enum":["forward","backward","center","edges","random"],"example":"forward","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.text.order","typeLabel":"enum\u003cstring>"},"smoothing":{"description":"Eases the delays across the units: `linear` is an even step, the other curves bunch the starts up at one end.","enum":["linear","smooth","natural","slow_down","accelerate","elastic","overshoot","impulse","swing"],"example":"linear","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.text.smoothing","typeLabel":"enum\u003cstring>"},"unit":{"description":"What animates on its own.","enum":["letters","words","lines"],"example":"words","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.text.unit","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0.text","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation.textOutro","typeLabel":"object | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings.keystrokes.animation","typeLabel":"object"},"colors":{"additionalProperties":false,"description":"Colors in #RRGGBB or #RRGGBBAA form.","properties":{"background":{"description":"The container behind the keys.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.colors.background","typeLabel":"string"},"keyBackground":{"description":"Each key's cap (or the pill).","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.colors.keyBackground","typeLabel":"string"},"keyText":{"description":"The key labels.","example":"#FFFFFF","pattern":"^#(?:[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.colors.keyText","typeLabel":"string"}},"required":["background","keyBackground","keyText"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.colors","typeLabel":"object"},"displayDurationMs":{"description":"How long a chord lingers after its key is released, in milliseconds.","example":1000,"maximum":10000,"minimum":300,"type":"integer","isRequired":true,"uniqueKey":"video.settings.keystrokes.displayDurationMs","typeLabel":"integer"},"enabled":{"description":"Show the HUD.","example":true,"type":"boolean","isRequired":true,"uniqueKey":"video.settings.keystrokes.enabled","typeLabel":"boolean"},"filter":{"description":"`shortcuts` shows only chords with a modifier, such as ⌘C or ⇧Tab, and hides typing, capitals and shifted symbols included; `all` also shows plain typing, including any text typed while recording.","enum":["shortcuts","all"],"example":"shortcuts","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.filter","typeLabel":"enum\u003cstring>"},"position":{"additionalProperties":false,"description":"Anchor of the HUD as a fraction of the frame. `alignment` says which horizontal edge of the HUD sits on x.","properties":{"x":{"description":"0 is the left edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.position.x","typeLabel":"number"},"y":{"description":"0 is the top edge.","maximum":1,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.position.y","typeLabel":"number"}},"required":["x","y"],"type":"object","isRequired":true,"uniqueKey":"video.settings.keystrokes.position","typeLabel":"object"},"size":{"description":"Size multiplier from 0.5 to 4 (1 is a 44 px cap on a 1080p frame).","example":1,"maximum":4,"minimum":0.5,"type":"number","isRequired":true,"uniqueKey":"video.settings.keystrokes.size","typeLabel":"number"},"style":{"description":"`keycap` draws one rounded cap per key in a container; `pill` draws the chord as text in one box.","enum":["keycap","pill"],"example":"keycap","type":"string","isRequired":true,"uniqueKey":"video.settings.keystrokes.style","typeLabel":"enum\u003cstring>"},"labels":{"description":"The keyboard the keys are labelled for. Absent, each recording's own keyboard: ⌘ for the Mac app, Ctrl for Auto Capture takes. `both` shows a shortcut with Mac and Windows keys (⌘ C / Ctrl C).","enum":["mac","windows","both"],"type":"string","uniqueKey":"video.settings.keystrokes.labels","typeLabel":"enum\u003cstring>"},"typing":{"description":"How `filter: all` shows plain typing. `keys` (the default when absent) shows one key per press; `words` grows a run of typing as text in one chip (backspace trims it; a pause, Return or a shortcut ends it), while shortcuts and keys pressed on their own still show as keys.","enum":["keys","words"],"example":"words","type":"string","uniqueKey":"video.settings.keystrokes.typing","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"video.settings.keystrokes","typeLabel":"object"},"motionBlurAmount":{"description":"Motion blur strength, 0.1 (subtle) to 2 (strong); 1 is the default. Absent while motion blur is off.","example":1,"type":"number","uniqueKey":"video.settings.motionBlurAmount","typeLabel":"number"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.settings","typeLabel":"object"},"thumbnails":{"type":"object","description":"Available thumbnail URLs by format and resolution","properties":{"large":{"type":"object","description":"Large thumbnails (1280x720 landscape, 720x1280 portrait, 1080x1080 square)","properties":{"gif":{"description":"Animated GIF thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","format":"uri","type":"string","uniqueKey":"video.thumbnails.large.gif","typeLabel":"string\u003curi>"},"jpg":{"description":"JPEG thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","format":"uri","type":"string","uniqueKey":"video.thumbnails.large.jpg","typeLabel":"string\u003curi>"},"mp4":{"description":"Animated MP4 thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","format":"uri","type":"string","uniqueKey":"video.thumbnails.large.mp4","typeLabel":"string\u003curi>"},"webp":{"description":"WebP thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp","format":"uri","type":"string","uniqueKey":"video.thumbnails.large.webp","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"video.thumbnails.large","typeLabel":"object"},"medium":{"type":"object","description":"Medium thumbnails with animated formats (640x360 landscape, 360x640 portrait, 640x640 square)","properties":{"gif":{"description":"Animated GIF thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","format":"uri","type":"string","uniqueKey":"video.thumbnails.medium.gif","typeLabel":"string\u003curi>"},"jpg":{"description":"JPEG thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","format":"uri","type":"string","uniqueKey":"video.thumbnails.medium.jpg","typeLabel":"string\u003curi>"},"mp4":{"description":"Animated MP4 thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","format":"uri","type":"string","uniqueKey":"video.thumbnails.medium.mp4","typeLabel":"string\u003curi>"},"webp":{"description":"WebP thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp","format":"uri","type":"string","uniqueKey":"video.thumbnails.medium.webp","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"video.thumbnails.medium","typeLabel":"object"},"small":{"type":"object","description":"Small thumbnails with animated formats (320x180 landscape, 180x320 portrait, 320x320 square)","properties":{"gif":{"description":"Animated GIF thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","format":"uri","type":"string","uniqueKey":"video.thumbnails.small.gif","typeLabel":"string\u003curi>"},"jpg":{"description":"JPEG thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","format":"uri","type":"string","uniqueKey":"video.thumbnails.small.jpg","typeLabel":"string\u003curi>"},"mp4":{"description":"Animated MP4 thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","format":"uri","type":"string","uniqueKey":"video.thumbnails.small.mp4","typeLabel":"string\u003curi>"},"webp":{"description":"WebP thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp","format":"uri","type":"string","uniqueKey":"video.thumbnails.small.webp","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"video.thumbnails.small","typeLabel":"object"},"xl":{"type":"object","description":"Extra large thumbnails (1920x1080 landscape, 1080x1920 portrait, 1080x1080 square)","properties":{"gif":{"description":"Animated GIF thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","format":"uri","type":"string","uniqueKey":"video.thumbnails.xl.gif","typeLabel":"string\u003curi>"},"jpg":{"description":"JPEG thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","format":"uri","type":"string","uniqueKey":"video.thumbnails.xl.jpg","typeLabel":"string\u003curi>"},"mp4":{"description":"Animated MP4 thumbnail URL (medium and small sizes only)","example":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","format":"uri","type":"string","uniqueKey":"video.thumbnails.xl.mp4","typeLabel":"string\u003curi>"},"webp":{"description":"WebP thumbnail URL","example":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp","format":"uri","type":"string","uniqueKey":"video.thumbnails.xl.webp","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"video.thumbnails.xl","typeLabel":"object"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.thumbnails","typeLabel":"object"},"transcript":{"type":"object","description":"Video transcript data","required":["status","language","text","sentences"],"properties":{"language":{"oneOf":[{"description":"Detected language code (e.g., 'en', 'es')","example":"en","type":"string","isRequired":true,"uniqueKey":"video.transcript.language.oneOf.0","typeLabel":"string"},{"description":"Detected language code (e.g., 'en', 'es')","example":"en","type":"null","isRequired":true,"uniqueKey":"video.transcript.language.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.transcript.language","typeLabel":"string | null"},"sentences":{"oneOf":[{"description":"Sentences with timestamps","items":{"additionalProperties":false,"description":"A sentence from the transcript with timestamps","properties":{"endSeconds":{"description":"Sentence end time in seconds","example":2.3,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.transcript.sentences.oneOf.0.items.[INDEX].endSeconds","typeLabel":"number"},"startSeconds":{"description":"Sentence start time in seconds","example":0.5,"minimum":0,"type":"number","isRequired":true,"uniqueKey":"video.transcript.sentences.oneOf.0.items.[INDEX].startSeconds","typeLabel":"number"},"text":{"description":"Sentence text","example":"Hello and welcome to this tutorial.","type":"string","isRequired":true,"uniqueKey":"video.transcript.sentences.oneOf.0.items.[INDEX].text","typeLabel":"string"}},"required":["text","startSeconds","endSeconds"],"type":"object","uniqueKey":"video.transcript.sentences.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"video.transcript.sentences.oneOf.0","typeLabel":"object[]"},{"description":"Sentences with timestamps","items":{"additionalProperties":false,"description":"A sentence from the transcript with timestamps","properties":{"endSeconds":{"description":"Sentence end time in seconds","example":2.3,"minimum":0,"type":"number"},"startSeconds":{"description":"Sentence start time in seconds","example":0.5,"minimum":0,"type":"number"},"text":{"description":"Sentence text","example":"Hello and welcome to this tutorial.","type":"string"}},"required":["text","startSeconds","endSeconds"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"video.transcript.sentences.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.transcript.sentences","typeLabel":"object[] | null"},"status":{"description":"Transcript generation status","enum":["ready","processing","failed"],"example":"ready","type":"string","isRequired":true,"uniqueKey":"video.transcript.status","typeLabel":"enum\u003cstring>"},"text":{"oneOf":[{"description":"Full transcript text","example":"Hello and welcome to this tutorial...","type":"string","isRequired":true,"uniqueKey":"video.transcript.text.oneOf.0","typeLabel":"string"},{"description":"Full transcript text","example":"Hello and welcome to this tutorial...","type":"null","isRequired":true,"uniqueKey":"video.transcript.text.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"video.transcript.text","typeLabel":"string | null"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"video.transcript","typeLabel":"object"},"updatedAt":{"description":"ISO 8601 datetime","example":"2024-01-15T14:45:00.000Z","format":"date-time","type":"string","isRequired":true,"uniqueKey":"video.updatedAt","typeLabel":"string\u003cdate-time>"},"views":{"description":"Total view count","example":1234,"maximum":9007199254740991,"minimum":0,"type":"integer","isRequired":true,"uniqueKey":"video.views","typeLabel":"integer"}},"required":["id","name","description","views","aspectRatio","dimensions","autoRatio","createdAt","updatedAt","durationSeconds","chapters","transcript","thumbnails","exports","settings","links","playlistIds","clipIds","backgroundMusic"],"type":"object","isRequired":true,"uniqueKey":"video","typeLabel":"object"}},"required":["video"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"video":{"aspectRatio":"16:9","autoRatio":false,"backgroundMusic":{"durationMs":180036,"name":"Calm Product Tour","url":"https://ucarecdn.com/example-track/","volume":0.2},"chapters":[{"description":"Overview of what we'll cover","timestampSeconds":0,"title":"Introduction"}],"clipIds":["cl_abc123","cl_def456"],"createdAt":"2024-01-15T10:30:00.000Z","description":"Learn how to create and share your first video","dimensions":{"height":1080,"width":1920},"durationSeconds":125.5,"exports":[{"downloadUrl":"https://cdn.tella.tv/exports/vid_abc123/video.mp4","exportId":"Export-Story-vid_abc123def456/2026-01-15T10:00:00Z/Story/1920x1080/30FPS","progress":100,"status":"completed","updatedAt":"2024-01-15T15:00:00.000Z"}],"id":"vid_abc123def456","links":{"embedPage":"https://www.tella.tv/video/vid_abc123def456/embed","viewPage":"https://www.tella.tv/video/vid_abc123def456/view"},"name":"Getting Started with Tella","playlistIds":["pl_abc123","pl_def456"],"settings":{"allowedEmbedDomains":["example.com","mysite.org"],"callToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"callToActionsHidden":true,"captionFontFamily":"Inter","captionFontSize":64,"captionFontWeight":500,"captionGrouping":"chunked","captionLinesPerBlock":1,"captionPosition":{"x":0.5,"y":0.5},"captionSize":"medium","captionStyle":{"backgroundColor":"#5E51F8FF","name":"backdrop","textColor":"#5E51F8FF","wordLevelHighlights":true,"activeWordTextColor":"#5E51F8FF","backgroundBorderColor":"#5E51F8FF","backgroundBorderEnabled":true,"backgroundBorderWidth":0.25,"backgroundEnabled":true,"backgroundPadding":0.5,"backgroundRadius":1,"highlightColor":"#5E51F8FF","highlightMode":"text","maxWidth":0.65,"outlineColor":"#5E51F8FF","outlineEnabled":true,"outlineWidth":0.25,"shadowColor":"#5E51F8FF","shadowEnabled":true,"textCase":"original"},"captionsDefaultEnabled":true,"commentEmailsEnabled":false,"commentsEnabled":true,"creatorEnabled":true,"cursor":{"clickRipple":false,"hideWhenInactive":false,"returnToStart":false,"size":3.05,"smoothing":false,"style":"macTahoe","tilt":false,"tiltStrength":0.5},"customThumbnailURL":"https://example.com/custom-thumbnail.jpg","defaultClipTransition":"hard_cut","defaultPlaybackRate":1,"documentGenerationEnabled":true,"downloadsEnabled":true,"layoutAnimationStyle":"moderate","linkScope":"org","microphoneVolume":1,"motionBlur":true,"publishDateEnabled":true,"rawDownloadsEnabled":false,"searchEngineIndexingEnabled":true,"secondaryCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"shrinkCameraDuringZooms":true,"studioSound":false,"studioSoundLevel":"off","subtitlesEnabled":true,"systemAudioVolume":1,"thumbnailInpointMs":12000,"transcriptsEnabled":true,"viewCountEnabled":true,"workspaceCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"workspaceSecondaryCallToAction":{"label":"\u003cstring>","url":"https://docs.tella.com/help"},"zoomAnimationStyle":"moderate","eyeContact":{"cameras":1,"camerasReady":1,"enabled":true,"status":"ready"},"keystrokes":{"alignment":"center","animation":{"intro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"motionBlur":true,"outro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textIntro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}},"textOutro":{"blur":0,"clip":false,"durationMs":500,"easing":{"curve":"slow_down","intensity":0.5,"bezier":[0.25,0.1,0.25,1],"spring":{"damping":12,"mass":1,"stiffness":200}},"moveX":0,"moveY":-0.5,"opacity":0,"preset":"slide_up","rotate":0,"scale":1,"text":{"delayMs":100,"order":"forward","smoothing":"linear","unit":"words"}}},"colors":{"background":"#FFFFFF","keyBackground":"#FFFFFF","keyText":"#FFFFFF"},"displayDurationMs":1000,"enabled":true,"filter":"shortcuts","position":{"x":0.5,"y":0.5},"size":1,"style":"keycap","labels":"mac","typing":"words"},"motionBlurAmount":1},"thumbnails":{"large":{"gif":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","jpg":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","mp4":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","webp":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"},"medium":{"gif":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","jpg":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","mp4":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","webp":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"},"small":{"gif":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","jpg":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","mp4":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","webp":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"},"xl":{"gif":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif","jpg":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg","mp4":"https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4","webp":"https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp"}},"transcript":{"language":"en","sentences":[{"endSeconds":2.3,"startSeconds":0.5,"text":"Hello and welcome to this tutorial."}],"status":"ready","text":"Hello and welcome to this tutorial..."},"updatedAt":"2024-01-15T14:45:00.000Z","views":1234}}}},"exampleType":"generated"}},"description":"Video created","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"generated"},"b9ac1dcd-ca4c-40d8-a21f-b2384d4472a2":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"bad_request","message":"The request was malformed or contained invalid parameters."}}},"exampleType":"examples"}},"description":"The request was malformed or contained invalid parameters.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"7310b59b-f2c2-4659-8aee-b14724bed1c3":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"unauthorized","message":"Authentication is required. Provide a valid API key."}}},"exampleType":"examples"}},"description":"Authentication is required. Provide a valid API key.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"7292be94-4366-48b9-adc2-075b837e2041":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"forbidden","message":"You don't have permission to access this resource."}}},"exampleType":"examples"}},"description":"You don't have permission to access this resource.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"60c5695a-bc52-49db-99fe-b39502629741":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_found","message":"The requested resource was not found."}}},"exampleType":"examples"}},"description":"The requested resource was not found.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"753fcb5b-dacd-4699-9670-7298895da350":{"content":{"application/json":{"example":{"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."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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."}}},"exampleType":"examples"}},"description":"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.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"d3362cea-cf07-46a1-9037-95e2dc030c68":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"rate_limited","message":"You have exceeded the rate limit. Please slow down."}}},"exampleType":"examples"}},"description":"You have exceeded the rate limit. Please slow down.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying a rate-limited request","example":45,"schema":{"minimum":1,"type":"integer"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"3cb283de-c3a4-4de4-9e89-500df0315e2d":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"server_error","message":"An unexpected error occurred"}}},"exampleType":"examples"}},"description":"An unexpected error occurred","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"5fb9c83f-fce1-4d38-b370-67f0307bd2ed":{"content":{"application/json":{"example":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"docsUrl":"https://docs.tella.com/","error":"not_implemented","message":"The requested operation is not implemented."}}},"exampleType":"examples"}},"description":"The requested operation is not implemented.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"},"29c34808-cc0d-427c-81cb-0523a1d23fdb":{"content":{"application/json":{"example":{"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."},"schema":{"additionalProperties":false,"description":"Standard error response format","properties":{"docsUrl":{"description":"Link to Tella API documentation","example":"https://docs.tella.com/","format":"uri","type":"string","isRequired":true,"uniqueKey":"docsUrl","typeLabel":"string\u003curi>"},"error":{"description":"Machine-readable error code","enum":["bad_request","unauthorized","forbidden","not_found","rate_limited","server_error","conflict","edit_conflict","not_implemented","unavailable"],"example":"not_found","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"description":"Human-readable error message","example":"Resource not found","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["error","message","docsUrl"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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."}}},"exampleType":"examples"}},"description":"A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.","headers":{"Deprecation":{"description":"Indicates that an API operation is deprecated, following RFC 9745","example":"@1767225600","schema":{"type":"string"}},"RateLimit":{"description":"Current quota with remaining requests (`r`) and seconds until reset (`t`)","example":"\"public-api\";r=95;t=42","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Named quota policy with the request limit (`q`) and window in seconds (`w`)","example":"\"public-api\";q=100;w=60","schema":{"type":"string"}},"Sunset":{"description":"Indicates when a deprecated API operation will become unavailable, following RFC 8594","example":"Tue, 30 Jun 2026 23:59:59 GMT","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Maximum requests allowed in the current window","example":100,"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in the current window","example":95,"schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp in milliseconds when the window resets","example":1704067200000,"schema":{"format":"int64","type":"integer"}}},"exampleType":"examples"}},"security":{"fa6c1770-cd6c-4754-a024-716724c7a7a4":{"BearerAuth":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"d2aabac2-b2bc-4b47-a6f4-a26614a56f79":{"description":"Production","url":"https://api.tella.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key obtained from your Tella account settings","scheme":"bearer","type":"http","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key obtained from your Tella account settings","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"tella","siteName":"Tella","title":"Create a video - Tella","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[{"tab":"Help Center"},{"tab":"Developers"},{"tab":"Changelog"}]},"originalFileLocation":"api-reference/videos/create-a-video.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video\u0026#x27;s first clip. Without a sourceId the video is empty, as the editor\u0026#x27;s New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tella\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a video - Tella\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video\u0026#x27;s first clip. Without a sourceId the video is empty, as the editor\u0026#x27;s New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tella\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.tella.com/docs/api-reference/videos/create-a-video\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+a+video\u0026amp;description=Create+a+new+video.+From+an+uploaded+source%3A+create+a+source+%28POST+%2Fv1%2Fsources%29%2C+PUT+the+video+bytes+to+its+uploadUrl%2C+then+call+this+endpoint+with+the+sourceId\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=441948b3b611b1636be3fed9e33065ada4f11ce2cee51183e8763f92d12de988\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a video - Tella\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video\u0026#x27;s first clip. Without a sourceId the video is empty, as the editor\u0026#x27;s New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tella.mintlify.site/docs/_mintlify/api/og/v2?division=Videos\u0026amp;title=Create+a+video\u0026amp;description=Create+a+new+video.+From+an+uploaded+source%3A+create+a+source+%28POST+%2Fv1%2Fsources%29%2C+PUT+the+video+bytes+to+its+uploadUrl%2C+then+call+this+endpoint+with+the+sourceId\u0026amp;theme=83fc5c73f5b3900df40eca67\u0026amp;signature=441948b3b611b1636be3fed9e33065ada4f11ce2cee51183e8763f92d12de988\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/tella/dDRDWwVgURpbIwO7/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tella\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8278FA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.tella.com/docs/api-reference/videos/create-a-video\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/videos/create-a-video.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.tella.com/#organization\",\"name\":\"Tella\",\"url\":\"https://www.tella.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tella/znRZoQ3e3rlGBTT2/logo-light.svg?fit=max\u0026auto=format\u0026n=znRZoQ3e3rlGBTT2\u0026q=85\u0026s=dd044b03efe593b53353a039bfb31fbf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.tella.com/docs#website\",\"name\":\"Tella\",\"url\":\"https://www.tella.com/docs\",\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/create-a-video#webpage\",\"url\":\"https://www.tella.com/docs/api-reference/videos/create-a-video\",\"name\":\"Create a video\",\"description\":\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video's first clip. Without a sourceId the video is empty, as the editor's New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\",\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/create-a-video#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.tella.com/docs/api-reference/videos/create-a-video#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://www.tella.com/docs/api-reference/account/get-the-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Videos\",\"item\":\"https://www.tella.com/docs/api-reference/videos/list-connected-social-accounts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a video\",\"item\":\"https://www.tella.com/docs/api-reference/videos/create-a-video\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.tella.com/docs/api-reference/videos/create-a-video#apireference\",\"headline\":\"Create a video\",\"name\":\"Create a video\",\"description\":\"Create a new video. From an uploaded source: create a source (POST /v1/sources), PUT the video bytes to its uploadUrl, then call this endpoint with the sourceId, which becomes the new video's first clip. Without a sourceId the video is empty, as the editor's New video makes; add clips with POST /v1/videos/{id}/clips (an uploaded source) or POST /v1/motion/clips (Tella Motion).\",\"url\":\"https://www.tella.com/docs/api-reference/videos/create-a-video\",\"mainEntityOfPage\":{\"@id\":\"https://www.tella.com/docs/api-reference/videos/create-a-video#webpage\"},\"publisher\":{\"@id\":\"https://www.tella.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.tella.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tella\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tella\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/videos/create-a-video.md","siteName":"Tella","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"/changelog"},{"anchor":"Community","icon":"users","href":"https://community.tella.tv"},{"anchor":"System Status","icon":"signal","href":"https://status.tella.com"},{"anchor":"Contact Support","icon":"envelope","href":"mailto:support@tella.com"},{"anchor":"Debug","icon":"bug","href":"/help/support/debug-camera-and-microphone-issues"}]},"tabs":[{"tab":"Help Center","pages":[{"title":"Help Center","href":"/help/introduction/welcome"}]},{"tab":"Developers","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Set up the Tella MCP server for your AI agent","sidebarTitle":"AI agent setup","href":"/ai-onboarding"},{"title":"Quickstart","href":"/quickstart"},{"title":"Authentication","href":"/authentication"},{"title":"Rate limiting","href":"/rate-limiting"},{"title":"API versioning and deprecation","href":"/versioning"}]},{"group":"Guides","pages":[{"title":"Webhooks","href":"/webhooks"},{"title":"Model Context Protocol (MCP)","href":"/mcp-server"},{"title":"Media library API","href":"/media-library-api"},{"title":"Embed API","href":"/embed-api"}]},{"group":"MCP Tools","pages":[{"group":"Managing videos","pages":[{"title":"Videos","href":"/mcp-tools/videos"},{"title":"Playlists","href":"/mcp-tools/playlists"},{"title":"Tags","href":"/mcp-tools/tags"},{"title":"Agent chats","href":"/mcp-tools/agent-chats"},{"title":"Community skills","href":"/mcp-tools/community-skills"},{"title":"Webhooks","href":"/mcp-tools/webhooks"},{"title":"Social publishing","href":"/mcp-tools/social-publishing"},{"title":"Analytics","href":"/mcp-tools/analytics"},{"title":"Account","href":"/mcp-tools/account"},{"title":"Billing","href":"/mcp-tools/billing"},{"title":"Support","href":"/mcp-tools/support"}]},{"group":"Editing videos","pages":[{"title":"Batch edits","href":"/mcp-tools/batch-edits"},{"title":"Sources","href":"/mcp-tools/sources"},{"title":"Library","href":"/mcp-tools/library"},{"title":"AI media generation","href":"/mcp-tools/ai-media-generation"},{"title":"Auto Capture","href":"/mcp-tools/auto-capture"},{"title":"Backgrounds","href":"/mcp-tools/backgrounds"},{"title":"Chapters","href":"/mcp-tools/chapters"},{"title":"Clips","href":"/mcp-tools/clips"},{"title":"Layouts","href":"/mcp-tools/layouts"},{"title":"Cropping","href":"/mcp-tools/cropping"},{"title":"Background Music","href":"/mcp-tools/background-music"},{"title":"Zooms","href":"/mcp-tools/zooms"},{"title":"Mouse events","href":"/mcp-tools/mouse-events"},{"title":"Key events","href":"/mcp-tools/key-events"},{"title":"Camera faces","href":"/mcp-tools/camera-faces"},{"title":"Blurs and highlights","href":"/mcp-tools/blurs-and-highlights"},{"title":"Overlays","href":"/mcp-tools/overlays"},{"title":"Text overlays","href":"/mcp-tools/text-overlays"},{"title":"Shape overlays","href":"/mcp-tools/shape-overlays"},{"title":"Sound effects","href":"/mcp-tools/sound-effects"}]},{"group":"Tella Motion","pages":[{"title":"Tella Motion","href":"/mcp-tools/motion"},{"title":"Tella Motion commands","href":"/mcp-tools/motion-commands"},{"title":"Tella Motion properties, easing and fonts","href":"/mcp-tools/motion-values"},{"title":"Tella Motion effects","href":"/mcp-tools/motion-effects"}]}]},{"group":"API Reference","pages":[{"group":"Account","pages":[{"title":"Get the account","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/account","href":"/api-reference/account/get-the-account"}]},{"group":"Agent chats","pages":[{"title":"List a video's agent chats","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/agent-chats","href":"/api-reference/agent-chats/list-a-videos-agent-chats"},{"title":"Start an agent chat","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/agent-chats","href":"/api-reference/agent-chats/start-an-agent-chat"}]},{"group":"Analytics","pages":[{"title":"Get workspace analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics","href":"/api-reference/analytics/get-workspace-analytics"},{"title":"List workspace views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/analytics/views","href":"/api-reference/analytics/list-workspace-views"},{"title":"List a playlist's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}/views","href":"/api-reference/analytics/list-a-playlists-views"},{"title":"Get video analytics","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/analytics","href":"/api-reference/analytics/get-video-analytics"},{"title":"List a video's views","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/views","href":"/api-reference/analytics/list-a-videos-views"}]},{"group":"Auto Capture","pages":[{"title":"Report an Auto Capture take","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/auto-captures/{sourceId}/reports","href":"/api-reference/auto-capture/report-an-auto-capture-take"}]},{"group":"Backgrounds","pages":[{"title":"List available backgrounds","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/backgrounds","href":"/api-reference/backgrounds/list-available-backgrounds"}]},{"group":"Library","pages":[{"title":"List library items","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library","href":"/api-reference/library/list-library-items"},{"title":"Add a source to the library","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library","href":"/api-reference/library/add-a-source-to-the-library"},{"title":"Split an image into layers","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/decompositions","href":"/api-reference/library/split-an-image-into-layers"},{"title":"Generate media with AI","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/generations","href":"/api-reference/library/generate-media-with-ai"},{"title":"Get a generation's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/generations/{id}","href":"/api-reference/library/get-a-generations-status"},{"title":"Import media from a URL","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/library/imports","href":"/api-reference/library/import-media-from-a-url"},{"title":"Get an import's status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/library/imports/{id}","href":"/api-reference/library/get-an-imports-status"},{"title":"Capture a web page or social post","deprecated":true,"version":null,"openapi":"/openapi.json post /v1/library/screenshots","href":"/api-reference/library/capture-a-web-page-or-social-post"},{"title":"Remove a library item","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/library/{id}","href":"/api-reference/library/remove-a-library-item"}]},{"group":"Tella Motion","pages":[{"title":"Add a Tella Motion clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/clips","href":"/api-reference/tella-motion/add-a-tella-motion-clip"},{"title":"List Tella Motion documents","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents","href":"/api-reference/tella-motion/list-tella-motion-documents"},{"title":"Create a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents","href":"/api-reference/tella-motion/create-a-tella-motion-document"},{"title":"Summarize a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}","href":"/api-reference/tella-motion/summarize-a-tella-motion-document"},{"title":"Edit a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/commands","href":"/api-reference/tella-motion/edit-a-tella-motion-document"},{"title":"Inspect a composition","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/compositions/{compositionId}","href":"/api-reference/tella-motion/inspect-a-composition"},{"title":"Download a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/download","href":"/api-reference/tella-motion/download-a-tella-motion-document"},{"title":"Duplicate a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/motion/documents/{id}/duplicate","href":"/api-reference/tella-motion/duplicate-a-tella-motion-document"},{"title":"List a document's media","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/media","href":"/api-reference/tella-motion/list-a-documents-media"},{"title":"Inspect a node's properties","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes","href":"/api-reference/tella-motion/inspect-a-nodes-properties"},{"title":"Get a node's stored fields","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/nodes/raw","href":"/api-reference/tella-motion/get-a-nodes-stored-fields"},{"title":"Get a frame or preview of a Tella Motion document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/documents/{id}/thumbnail","href":"/api-reference/tella-motion/get-a-frame-or-preview-of-a-tella-motion-document"},{"title":"List Tella Motion effects","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/effects","href":"/api-reference/tella-motion/list-tella-motion-effects"},{"title":"List Tella Motion fonts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/fonts","href":"/api-reference/tella-motion/list-tella-motion-fonts"},{"title":"Get a Tella Motion JSON schema","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/motion/schema","href":"/api-reference/tella-motion/get-a-tella-motion-json-schema"}]},{"group":"Playlist Groups","pages":[{"title":"List playlist groups","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlist-groups","href":"/api-reference/playlist-groups/list-playlist-groups"},{"title":"Create a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlist-groups","href":"/api-reference/playlist-groups/create-a-playlist-group"},{"title":"Delete a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/delete-a-playlist-group"},{"title":"Rename or reorder a playlist group","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlist-groups/{id}","href":"/api-reference/playlist-groups/rename-or-reorder-a-playlist-group"}]},{"group":"Playlists","pages":[{"title":"List all playlists","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists","href":"/api-reference/playlists/list-all-playlists"},{"title":"Create a new playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists","href":"/api-reference/playlists/create-a-new-playlist"},{"title":"Get playlist details","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/playlists/{id}","href":"/api-reference/playlists/get-playlist-details"},{"title":"Delete a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}","href":"/api-reference/playlists/delete-a-playlist"},{"title":"Update a playlist","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/playlists/{id}","href":"/api-reference/playlists/update-a-playlist"},{"title":"Add a video to a playlist","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/playlists/{id}/videos","href":"/api-reference/playlists/add-a-video-to-a-playlist"},{"title":"Remove a video from a playlist","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/playlists/{id}/videos/{videoId}","href":"/api-reference/playlists/remove-a-video-from-a-playlist"}]},{"group":"Videos","pages":[{"title":"List connected social accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/social-accounts","href":"/api-reference/videos/list-connected-social-accounts"},{"title":"List subtitle presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/subtitle-presets","href":"/api-reference/videos/list-subtitle-presets"},{"title":"Save a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/subtitle-presets","href":"/api-reference/videos/save-a-subtitle-preset"},{"title":"List all videos","description":"Returns a paginated list of the authenticated user's videos (My videos). Use scope=workspace for every video shared with the workspace (Workspace videos), or playlistId to list a playlist's videos.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos","href":"/api-reference/videos/list-all-videos"},{"title":"Create a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos","href":"/api-reference/videos/create-a-video"},{"title":"Search videos","description":"Search the authenticated user's direct video library by title or indexed transcript sentences.","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/search","href":"/api-reference/videos/search-videos"},{"title":"Get video information","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}","href":"/api-reference/videos/get-video-information"},{"title":"Delete a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}","href":"/api-reference/videos/delete-a-video"},{"title":"Update a video","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}","href":"/api-reference/videos/update-a-video"},{"title":"Set background music","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/background-music","href":"/api-reference/videos/set-background-music"},{"title":"Remove background music","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/background-music","href":"/api-reference/videos/remove-background-music"},{"title":"Get the beats of the background music","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/background-music/beats","href":"/api-reference/videos/get-the-beats-of-the-background-music"},{"title":"Download video captions","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/captions","href":"/api-reference/videos/download-video-captions"},{"title":"Get video chapters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/chapters","href":"/api-reference/videos/get-video-chapters"},{"title":"Replace video chapters","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/chapters","href":"/api-reference/videos/replace-video-chapters"},{"title":"Add a collaborator to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/collaborators","href":"/api-reference/videos/add-a-collaborator-to-a-video"},{"title":"Generate a document from a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/documents","href":"/api-reference/videos/generate-a-document-from-a-video"},{"title":"Get a generated document","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/documents/{documentId}","href":"/api-reference/videos/get-a-generated-document"},{"title":"Duplicate a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/duplicate","href":"/api-reference/videos/duplicate-a-video"},{"title":"Apply many video edits","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/edits","href":"/api-reference/videos/apply-many-video-edits"},{"title":"List video exports","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports","href":"/api-reference/videos/list-video-exports"},{"title":"Start a video export","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/exports","href":"/api-reference/videos/start-a-video-export"},{"title":"Get video export status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/exports/{exportId}","href":"/api-reference/videos/get-video-export-status"},{"title":"Get a live preview link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/live-preview","href":"/api-reference/videos/get-a-live-preview-link"},{"title":"List social publications","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/publish","href":"/api-reference/videos/list-social-publications"},{"title":"Publish a video to social media","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/publish","href":"/api-reference/videos/publish-a-video-to-social-media"},{"title":"Cancel a scheduled publish","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/publish","href":"/api-reference/videos/cancel-a-scheduled-publish"},{"title":"Get a recording link","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/recording-link","href":"/api-reference/videos/get-a-recording-link"},{"title":"Get a video storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/storyboard","href":"/api-reference/videos/get-a-video-storyboard"},{"title":"Apply a subtitle preset","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/subtitle-preset","href":"/api-reference/videos/apply-a-subtitle-preset"},{"title":"Get a video thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/thumbnail","href":"/api-reference/videos/get-a-video-thumbnail-or-animated-preview"},{"title":"Set a video's thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json put /v1/videos/{id}/thumbnail","href":"/api-reference/videos/set-a-videos-thumbnail"},{"title":"Remove a video's custom thumbnail","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/thumbnail","href":"/api-reference/videos/remove-a-videos-custom-thumbnail"},{"title":"Get a video's timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/timeline","href":"/api-reference/videos/get-a-videos-timeline"}]},{"group":"Sources","pages":[{"title":"Create a source upload (video, audio, image, or LUT)","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/sources","href":"/api-reference/sources/create-a-source-upload-video-audio-image-or-lut"},{"title":"Get a source's processing status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}","href":"/api-reference/sources/get-a-sources-processing-status"},{"title":"Get the beats of an audio or video source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/beats","href":"/api-reference/sources/get-the-beats-of-an-audio-or-video-source"},{"title":"Get a streaming upload storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/storyboard","href":"/api-reference/sources/get-a-streaming-upload-storyboard"},{"title":"Get a thumbnail of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/thumbnail","href":"/api-reference/sources/get-a-thumbnail-of-a-source-on-no-clip"},{"title":"Get the transcript of a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/transcript","href":"/api-reference/sources/get-the-transcript-of-a-source-on-no-clip"},{"title":"Get the audio waveform JSON for a source on no clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/sources/{sourceId}/waveform","href":"/api-reference/sources/get-the-audio-waveform-json-for-a-source-on-no-clip"}]},{"group":"Tags","pages":[{"title":"List all tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/tags","href":"/api-reference/tags/list-all-tags"},{"title":"Create a new tag","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/tags","href":"/api-reference/tags/create-a-new-tag"},{"title":"Delete a tag","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/tags/{id}","href":"/api-reference/tags/delete-a-tag"},{"title":"Update a tag","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/tags/{id}","href":"/api-reference/tags/update-a-tag"},{"title":"List a video's tags","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/tags","href":"/api-reference/tags/list-a-videos-tags"},{"title":"Add a tag to a video","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/tags","href":"/api-reference/tags/add-a-tag-to-a-video"},{"title":"Remove a tag from a video","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/tags/{tagId}","href":"/api-reference/tags/remove-a-tag-from-a-video"}]},{"group":"Clips","pages":[{"title":"List text presets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/text-presets","href":"/api-reference/clips/list-text-presets"},{"title":"Save a text preset","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/text-presets","href":"/api-reference/clips/save-a-text-preset"},{"title":"Delete a text preset","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/text-presets/{presetId}","href":"/api-reference/clips/delete-a-text-preset"},{"title":"List clips for a video","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips","href":"/api-reference/clips/list-clips-for-a-video"},{"title":"Add a clip from an uploaded source","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips","href":"/api-reference/clips/add-a-clip-from-an-uploaded-source"},{"title":"Get a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/get-a-clip"},{"title":"Delete a clip","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/delete-a-clip"},{"title":"Update a clip","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}","href":"/api-reference/clips/update-a-clip"},{"title":"Get audio levels in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/audio-levels","href":"/api-reference/clips/get-audio-levels-in-a-clip"},{"title":"Auto-crop a clip's screen recording","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/auto-crop","href":"/api-reference/clips/auto-crop-a-clips-screen-recording"},{"title":"List blurs on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/list-blurs-on-a-clip"},{"title":"Add a blur to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/blurs","href":"/api-reference/clips/add-a-blur-to-a-clip"},{"title":"Remove a blur","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/remove-a-blur"},{"title":"Update a blur","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/blurs/{maskId}","href":"/api-reference/clips/update-a-blur"},{"title":"List faces in a clip's camera","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/camera-faces","href":"/api-reference/clips/list-faces-in-a-clips-camera"},{"title":"Cut one or more time ranges from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut","href":"/api-reference/clips/cut-one-or-more-time-ranges-from-a-clip"},{"title":"Cut clip ranges by transcript word indices","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/cut-by-transcript","href":"/api-reference/clips/cut-clip-ranges-by-transcript-word-indices"},{"title":"Duplicate a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/duplicate","href":"/api-reference/clips/duplicate-a-clip"},{"title":"Get clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/get-clip-color-filters"},{"title":"Set clip color filters","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/filters","href":"/api-reference/clips/set-clip-color-filters"},{"title":"List highlights on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/list-highlights-on-a-clip"},{"title":"Add a highlight to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/highlights","href":"/api-reference/clips/add-a-highlight-to-a-clip"},{"title":"Remove a highlight","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/remove-a-highlight"},{"title":"Update a highlight","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/highlights/{maskId}","href":"/api-reference/clips/update-a-highlight"},{"title":"List key presses on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/key-events","href":"/api-reference/clips/list-key-presses-on-a-clip"},{"title":"List layouts on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/list-layouts-on-a-clip"},{"title":"Add a layout to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/layouts","href":"/api-reference/clips/add-a-layout-to-a-clip"},{"title":"Remove a layout","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/remove-a-layout"},{"title":"Update a layout","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/layouts/{layoutId}","href":"/api-reference/clips/update-a-layout"},{"title":"List mouse events on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/mouse-events","href":"/api-reference/clips/list-mouse-events-on-a-clip"},{"title":"List overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/list-overlays-on-a-clip"},{"title":"Add an overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/overlays","href":"/api-reference/clips/add-an-overlay-to-a-clip"},{"title":"Remove an overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/remove-an-overlay"},{"title":"Update an overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/overlays/{overlayId}","href":"/api-reference/clips/update-an-overlay"},{"title":"Remove filler words from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-fillers","href":"/api-reference/clips/remove-filler-words-from-a-clip"},{"title":"Remove silences from a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/remove-silences","href":"/api-reference/clips/remove-silences-from-a-clip"},{"title":"Reorder a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/reorder","href":"/api-reference/clips/reorder-a-clip"},{"title":"List shape overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/list-shape-overlays-on-a-clip"},{"title":"Add a shape overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/shape-overlays","href":"/api-reference/clips/add-a-shape-overlay-to-a-clip"},{"title":"Remove a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/remove-a-shape-overlay"},{"title":"Update a shape overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/shape-overlays/{shapeOverlayId}","href":"/api-reference/clips/update-a-shape-overlay"},{"title":"Get silent ranges in a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/silences","href":"/api-reference/clips/get-silent-ranges-in-a-clip"},{"title":"List sound effects on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/list-sound-effects-on-a-clip"},{"title":"Add a sound effect to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/sound-effects","href":"/api-reference/clips/add-a-sound-effect-to-a-clip"},{"title":"Remove a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/remove-a-sound-effect"},{"title":"Update a sound effect","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/sound-effects/{soundEffectId}","href":"/api-reference/clips/update-a-sound-effect"},{"title":"List sources for a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources","href":"/api-reference/clips/list-sources-for-a-clip"},{"title":"Get a source thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/thumbnail","href":"/api-reference/clips/get-a-source-thumbnail-or-animated-preview"},{"title":"Get the audio waveform JSON for a source","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/sources/{sourceId}/waveform","href":"/api-reference/clips/get-the-audio-waveform-json-for-a-source"},{"title":"Split a clip in two","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/split","href":"/api-reference/clips/split-a-clip-in-two"},{"title":"Get a clip storyboard","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/storyboard","href":"/api-reference/clips/get-a-clip-storyboard"},{"title":"List text overlays on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/list-text-overlays-on-a-clip"},{"title":"Add a text overlay to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/text-overlays","href":"/api-reference/clips/add-a-text-overlay-to-a-clip"},{"title":"Remove a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/remove-a-text-overlay"},{"title":"Update a text overlay","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/text-overlays/{textOverlayId}","href":"/api-reference/clips/update-a-text-overlay"},{"title":"Get a clip thumbnail or animated preview","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/thumbnail","href":"/api-reference/clips/get-a-clip-thumbnail-or-animated-preview"},{"title":"Get clip transcript","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/transcript","href":"/api-reference/clips/get-clip-transcript"},{"title":"Correct transcript words","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/transcript/words","href":"/api-reference/clips/correct-transcript-words"},{"title":"List zooms on a clip","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/list-zooms-on-a-clip"},{"title":"Add a zoom to a clip","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms","href":"/api-reference/clips/add-a-zoom-to-a-clip"},{"title":"Auto-generate zooms from mouse activity","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/videos/{id}/clips/{clipId}/zooms/auto","href":"/api-reference/clips/auto-generate-zooms-from-mouse-activity"},{"title":"Remove a zoom","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/remove-a-zoom"},{"title":"Update a zoom","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/videos/{id}/clips/{clipId}/zooms/{zoomId}","href":"/api-reference/clips/update-a-zoom"}]},{"group":"Webhooks","pages":[{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/webhooks/endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json delete /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/openapi.json patch /v1/webhooks/endpoints/{id}","href":"/api-reference/webhooks/update-a-webhook-endpoint"},{"title":"Get endpoint signing secret","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/endpoints/{id}/secret","href":"/api-reference/webhooks/get-endpoint-signing-secret"},{"title":"List recent webhook messages","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages","href":"/api-reference/webhooks/list-recent-webhook-messages"},{"title":"Get a specific webhook message","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/webhooks/messages/{id}","href":"/api-reference/webhooks/get-a-specific-webhook-message"}]}]},{"group":"Webhooks","pages":[{"group":"Videos","pages":[{"title":"Document generated","version":null,"deprecated":null,"openapi":"/webhooks.json webhook document.generated","href":"/api-reference/videos/document-generated"},{"title":"Export ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook export.ready","href":"/api-reference/videos/export-ready"},{"title":"Transcript ready","version":null,"deprecated":null,"openapi":"/webhooks.json webhook transcript.ready","href":"/api-reference/videos/transcript-ready"},{"title":"Video created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.created","href":"/api-reference/videos/video-created"},{"title":"View milestone reached","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.milestone","href":"/api-reference/videos/view-milestone-reached"},{"title":"Video viewed","version":null,"deprecated":null,"openapi":"/webhooks.json webhook video.viewed","href":"/api-reference/videos/video-viewed"}]},{"group":"Playlists","pages":[{"title":"Playlist created","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.created","href":"/api-reference/playlists/playlist-created"},{"title":"Video added to playlist","version":null,"deprecated":null,"openapi":"/webhooks.json webhook playlist.video_added","href":"/api-reference/playlists/video-added-to-playlist"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Create a video - Tella","deploymentId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","buildId":"dpl_53YqbBPsHdrqSGqXiWPGU7csRVod","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Ku9dSkH0.js","snippetPresets-Cjez4eet.js","utils-BqNa-fnS.js","style-to-object-BY3JEAdk.js","utils-DiE92JCe.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-Bi0DpqVf.js","conditional-requirements-CFM0id0Q.js","cloneDeep-C6xnxscF.js","_Uint8Array-B7g0OYAt.js","isObject-FP1Yky1u.js","ApiExamples-Bf8Ecb5t.js","usePlaygroundInputsStore-BA942cq6.js","shallow-D0sePNkF.js","isEqual-CnnQO8sL.js","CodeSnippets-BTANoy1T.js","CodeSnippet-CTZvgJfu.js","getApiPlaygroundDisplay-BK2o1XYu.js","Page--B9YZ09u.js","DynamicMarkdown-CsgNpZb1.js","SectionHeading-C3K437Dy.js","icon-DlxjjqnB.js","MethodPill-Cr7Ib9nN.js","getPastedJson-DXo3wtHt.js","Check2Icon-ChEI-f_B.js","axios-CsQoIw0U.js","Markdown-CH4mv0N8.js","AssistantPageLink-BHjmqccN.js","dist-DYCPzQwJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}