REreap

Create Reframe

Changed on

Automatically reframe videos for different aspect ratios

post/automation/create-reframe

Request

  • Base URL
    https://public.reap.video/api/v1
  • URL
    https://public.reap.video/api/v1/automation/create-reframe
  • Auth
    HTTP bearer

Request body

sourceUrlstring

Video URL to process, e.g. a YouTube link (alternative to uploadId)

uploadIdstring

Upload ID from a previously uploaded file (alternative to sourceUrl)

genre'talking' | 'screenshare' | 'gaming'

Video genre for better AI analysis

orientation'portrait' | 'square'

Target orientation

exportResolution720 | 1080 | 1440 | 2160

Output resolution for the reframed video. Resolutions above 1080 require a Studio plan. Capped at the source's actual resolution.

selectedStartnumber nullable

Start time in seconds of the window to reframe (defaults to the start of the video)

selectedEndnumber nullable

End time in seconds of the window to reframe (defaults to the end of the video). The selected window must be between 3 seconds and 10 minutes; only the window is billed.

disableAutoSplitboolean

Whether to disable automatic splitting into segments

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
exportResolutioninteger
exportOrientation'landscape' | 'portrait' | 'square'
captionsPresetstring nullable
enableCaptionsboolean
enableEmojisboolean
enableHighlightsboolean
languagestring nullable
dubbingLanguagestring nullable
translateTranscriptionboolean
translationLanguagesstring[]
transcriptionScript'native' | 'roman'
createdAtinteger
updatedAtinteger

Changes

  • 4dd80bac4a44Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      the request property became optional

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status