Storyboard API: Scene Object Parameters

Scenes object is part of Storyboard API and which is used to determine the Video/Visual for the specific scene. The Video is generated based on the text, audio or visual scenes to generate video preview.

Each Scene object can be represented by one of the following parameters:

  1. Text: Text using which video needs to be generated. Pictory AI will generate a video for each sentence given in the text parameter.
  2. Visuals/video blocks: This is represented as backgroundUri in the scene object.
  3. Article URL: The URL of the blog/webpage to be converted to the video.

📘

NOTE: You must pass atleast of the mentioned parameter: text, article_url or backgroundUri (video/visual blocks) in the scenes object.

Parameter
Name
Parameter
Type
Description
texttextText using which a video needs to be generated. AI will generate a video for each sentence provided in the text parameter.
In case backgroundUri is provided the text parameter here can be used as the subtitle.

The text attribute also supports SSML tags.
article_urlURLPass the URL of the blog/webpage to be converted to the video.
backgroundUriURLBackground URL for Visual/Video Block. backgroundUri can be of two types: video or image.
minDurationIntegerThe minimum scene duration which needs to be considered for backgroundUri
backgroundTypeChoice
(image, video)
Type of backgroundUri can be one of the following:

image

video
backgroundVideoSegmentsBackgroundVideoSegmentsThis object defines the start time and end time of the video block.
voiceOverboolean
Default Value: false
Weather AI Voice needs to be used in this video scene.
voiceOverUriURLPass the URL of the custom Voiceover to be used in the video.
voiceOverSegmentVoiceOverSegmentThis object defines the start time and end time of the video block.
subtitlesboolean
Default Value: true
Weather subtitles need to be used in this video scene.
splitTextOnNewLinebooleanThis parameter is used to split the scene after each sentence.
splitTextOnPeriodbooleanThis parameter is used to split the scene after each Paragraph.
fontFamily Choice.
Default value: Arial
Font of the Text. The supported Font list is mentioned here.
fontWeightChoice.
Default Value: normal
Accepted values: [normal, semi-bold, bold]
textColortext
Default Value: rgba(255,255,255,255)
Color of the Text in hex-code (eg: #FFFFFF)
fontSizeInteger
Default Value: 32
Size of the text.
textBackgroundColortext
Default Value:
rgba(17,17,17,153)
The background color of the subtitle in hex-code (e.g: #FFFFFF)
textShadowColortext The shadow color of the subtitle in hex-code.
horizontalAlignmentChoice
Default Value: left
Horizontal alignment of the text. Supported values are:
left : Align text to the left.
center: Align the text to the center.
right: Align the text to the right.`
verticalAlignmentChoice
Default Value: bottom
Vertical alignment of the text. Supported values are:
top : Align text to the left.
center: Align the text to the center.
bottom: Align the text to the right.

BackgroundVideoSegments

BackgroundVideoSegments object can be passed to tell the start time and end time of the video that needs to be clipped from the backgroundUri.

Parameter NameParameter TypeDescription
startintThe start time of the video that needs to be clipped for the video scene mentioned in scenes.backgroundUri
endintThe end time of the video that needs to be clipped for the video scene mentioned in scenes.backgroundUri.
backgroundVideoSegments: [{
          start: startTime,
          end: endTime,
        }]