v1
latestOpenAPI 3.1.02026-07-22284533.8 KBCreate Captions
Add AI-generated captions to your videos
post/automation/create-captions
Request body
sourceUrlstring
Direct URL to a video file (alternative to uploadId)
uploadIdstring
Upload ID from a previously uploaded file (alternative to sourceUrl)
captionsPresetstring nullable
Caption style preset ID. Defaults to system_beasty if not specified.
languagestring nullable
Primary language of the video content (auto-detected if not provided)
translationLanguagestring nullable
Language to translate captions to
transcriptionScript'native' | 'roman'
Script format for transcription output
enableEmojisboolean
Whether to add contextual emojis to captions
enableHighlightsboolean
Whether to highlight keywords in captions
resolution720 | 1080 | 1440 | 2160
Output resolution (only applicable when sourceUrl is provided)
Response
Successful response
idstring
titlestring
thumbnailstring
billedDurationnumber
status'queued' | 'prepped' | 'draft' | 'processing' | 'finalizing' | 'completed' | 'invalid' | 'expired' | 'failed' | 'error'
projectType'clipping' | 'captions' | 'reframe' | 'dubbing' | 'transcription'
source'Upload' | 'Youtube' | 'Vimeo' | 'TwitchVod' | 'Twitter' | 'RumbleEmbed' | 'Generic'
genre'talking' | 'screenshare' | 'gaming'
topicsstring[]
selectedStartnumber nullable
selectedEndnumber nullable
reframeClipsboolean
exportResolutioninteger
exportOrientation'landscape' | 'portrait' | 'square'
captionsPresetstring nullable
enableCaptionsboolean
enableEmojisboolean
enableHighlightsboolean
languagestring nullable
dubbingLanguagestring nullable
translateTranscriptionboolean
translationLanguagesstring[]
transcriptionScript'native' | 'roman'
urlsobject
createdAtinteger
updatedAtinteger