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 parameter specifies the text and optional background URI for generating videos. 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 for enhanced text-to-speech synthesis.

Additionally, specific keywords in the text can be highlighted using tags.

Example usage: <strong>sample highlighted text here</strong>
mediaSearchQuerytextmediaSearchQuery parameter allows you to input text specifically for searching background visuals, separate from the main content of your video.
captiontextThis parameter enables you to provide text for subtitles, ensuring your audience can easily follow along with the audio content. If the caption parameter is not provided, the text value will be used as the subtitle text.
keywordColortext
Default Value: ## e2e2aad9
Color of the highlighted keyword in the subtitle text.
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.
minimumDurationIntegerThe minimum scene duration that 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 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.
subtitleboolean
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: 24
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.
zoomAndPanBoolean
Default Value: true
The visual provided in the backgrounUri in the video is automatically set to zoom and pan. To disable this feature, set the value to false.
transitionChoice Transition to be used between the current scene and the next scene.
Supported Values: none, wipeup, wipedown, wipeleft, wiperight, smoothleft, smoothright, radial, circlecrop, hblur, fade
muteBackgroundVideoBoolean
Default Value: false
To mute the audio playback of the video file used in backgrounUri scene set this value to true.
loopBackgroundVideoBooleanTo disable the looping of the background scene visual, set the value to false
durationGainFixedintTo extend the display duration of the scene, provide the duration in seconds using this parameter.
durationGainPercentageintTo extend the display duration of the scene, provide the duration in percent using this parameter.

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,
        }]