improved

Introducing mediaSearchQuery and caption Parameters for Enhanced Video Creation

We are excited to announce two new enhancements to our Storyboard API for text-to-video use cases: the mediaSearchQuery and caption parameters inside scenes object. These features provide you with more control and flexibility in creating your videos, improving both the visual and textual components.

What's New?

  1. mediaSearchQuery Parameter

This parameter allows you to input text specifically for searching background visuals, separate from the main content of your video.

📘
  1. If the mediaSearchQuery parameter is not provided, our AI will automatically use the existing text parameter value is used to search for appropriate background visuals, ensuring continuity and relevance.

  1. Instead of using search keywords, try using sentences in the mediaSearchQuery like "Man walking with a dog".
  1. caption Parameter

This 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 parameter value will be used as the subtitle text.

Benefits

  1. Targeted Visuals: With the mediaSearchQuery parameter, you can ensure that the background visuals are perfectly aligned with your video's theme or context by providing a separate search query.
  2. Enhanced Subtitles: The caption parameter allows for clear and accurate subtitles, making your videos more accessible and engaging.

Sample Storyboard Request

{
    "videoName": "Generated joke Video",
    "videoDescription": "A  joke story.",
    "language": "en",
    "audio": {
        "aiVoiceOver": {
            "speaker": "Jackson",
            "speed": "100",
            "amplifyLevel": "1"
        },
        "autoBackgroundMusic": true,
        "backGroundMusicVolume": 1
    },
    "brandLogo": {
        "url": "<BRAND_LOGO_URL>",
        "verticalAlignment": "top",
        "horizontalAlignment": "right"
    },
    "videoWidth": "1920",
    "videoHeight": "1080",
    "textStyles": {
        "fontFamily": "Arial",
        "textColor": "#FFFFFF",
        "fontSize": 24,
        "textBackgroundColor": "#000000",
        "verticalAlignment": "bottom",
        "horizontalAlignment": "center"
    },
    "scenes": [
        {
            "mediaSearchQuery": "Animated image of a baby fighting a young man",
            "text": "What do Keanu Reeves and baby Yoda have in common?",
            "caption": "Do you see something in common in Keanu Reeves and baby Yoda?",
            "voiceOver": true,
            "splitTextOnNewLine": true,
            "splitTextOnPeriod": true,
            "minimumDuration": 10
        },
        {
            "mediaSearchQuery": "Animated image of a laughing baby",
            "text": "They age at the same rate",
            "caption": "Both of them never gets old.",
            "voiceOver": true,
            "splitTextOnNewLine": true,
            "splitTextOnPeriod": true,
            "minimumDuration": 10
        }
    ]
}