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 only one of the mentioned parameter: text, article_url or backgroundUri (video/visual blocks) in the scenes object.

Parameter NameParameter TypeDescription
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.
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. Type of
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.
voiceOverbooleanWeather AI Voice needs to be used in the video.
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 subtitle. The supported Font list is mentioned here.
textColortext
Default Value: rgba(255,255,255,255)
Text color of the subtitle in hex-code (eg: #FFFFFF)
fontSizeInteger
Default Value: 32
Size of the subtitle text.
textBackgroundColortext
Default Value:rgba(17,17,17,153)
The background color of the subtitle in hex-code (e.g: #FFFFFF)

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