Skip to main content
This guide shows you how to create videos with smart layouts that enhance the visual presentation of your content. Smart layouts provide professionally designed templates that combine text, visuals, and animations for engaging video content.
Smart Layout Options

What You’ll Learn

Smart Layouts

Apply professionally designed visual layouts

Layout Selection

Choose layouts by name or ID

Visual Styles

Create consistent, polished video aesthetics

Combined Features

Use layouts with voice-over and other features

Before You Begin

Make sure you have:
  • A Pictory API key (get one here)
  • Node.js or Python installed on your machine
  • Text content ready for video conversion
  • Understanding of which layout style fits your content
npm install axios

Available Smart Layouts

Pictory provides five distinct smart layout styles, each designed for different content types and visual aesthetics:
Layout NameStyleBest Used For
Modern minimalistClean, professional design with subtle animationsBusiness presentations, corporate content, professional tutorials
KineticDynamic, energetic layout with bold typographyMarketing videos, product launches, social media ads
ChicElegant, sophisticated design with stylish elementsFashion, lifestyle content, premium brand videos
WanderlustTravel-inspired layout with split-screen visualsTravel content, testimonials, storytelling videos
BulletinNews-style layout with structured information displayEducational content, news updates, informational videos
Smart layouts automatically handle text positioning, animations, and visual styling. When using smart layouts, the maxSubtitleLines parameter is not available at the scene level as the layout manages text display automatically.

How Smart Layouts Work

When you apply a smart layout to your video:
  1. Layout Selection - You specify the layout by name or ID
  2. Text Processing - Your story content is analyzed and formatted
  3. Visual Styling - Layout-specific styling is applied to text and elements
  4. Animation Application - Pre-designed animations enhance visual appeal
  5. Scene Composition - Text, visuals, and backgrounds are combined
  6. Video Rendering - Final video is assembled with the complete layout design

Complete Example

import axios from "axios";

const API_BASE_URL = "https://api.pictory.ai/pictoryapis";
const API_KEY = "YOUR_API_KEY";

const SAMPLE_TEXT =
  "AI is poised to significantly impact educators and course creators on social media. " +
  "By automating tasks like content generation, visual design, and video editing, " +
  "AI will save time and enhance consistency.";

async function createVideoWithSmartLayout() {
  try {
    console.log("Creating video with smart layout...");

    const response = await axios.post(
      `${API_BASE_URL}/v2/video/storyboard/render`,
      {
        videoName: "text_to_video_smart_layout",

        // Smart layout configuration
        smartLayoutName: "modern minimalist",  // Choose your layout

        // Voice-over configuration
        voiceOver: {
          enabled: true,
          aiVoices: [
            {
              speaker: "Brian",              // AI voice name
              speed: 100,                    // Normal speed (50-200)
              amplificationLevel: 0,         // Normal volume (-1 to 1)
            },
          ],
        },

        // Scene configuration
        scenes: [
          {
            story: SAMPLE_TEXT,
            createSceneOnNewLine: true,
            createSceneOnEndOfSentence: true,
          },
        ],
      },
      {
        headers: {
          "Content-Type": "application/json",
          Authorization: API_KEY,
        },
      }
    );

    const jobId = response.data.data.jobId;
    console.log("✓ Video creation started!");
    console.log("Job ID:", jobId);

    // Monitor progress
    console.log("\nMonitoring video creation...");
    let jobCompleted = false;
    let jobResult = null;

    while (!jobCompleted) {
      const statusResponse = await axios.get(
        `${API_BASE_URL}/v1/jobs/${jobId}`,
        {
          headers: { Authorization: API_KEY },
        }
      );

      const status = statusResponse.data.data.status;
      console.log("Status:", status);

      if (status === "completed") {
        jobCompleted = true;
        jobResult = statusResponse.data;
        console.log("\n✓ Video with smart layout is ready!");
        console.log("Video URL:", jobResult.data.videoURL);
      } else if (status === "failed") {
        throw new Error("Video creation failed: " + JSON.stringify(statusResponse.data));
      }

      await new Promise(resolve => setTimeout(resolve, 5000));
    }

    return jobResult;
  } catch (error) {
    console.error("Error:", error.response?.data || error.message);
    throw error;
  }
}

createVideoWithSmartLayout();

Understanding the Parameters

Smart Layout Configuration

ParameterTypeRequiredDescription
smartLayoutNamestringNoName of the smart layout (use this OR smartLayoutId, not both)
smartLayoutIdstringNoID of the smart layout (use this OR smartLayoutName, not both)

Valid Smart Layout Names

ValueDescription
modern minimalistClean, professional design with subtle animations
kineticDynamic, energetic layout with bold typography
chicElegant, sophisticated design with stylish elements
wanderlustTravel-inspired layout with split-screen visuals
bulletinNews-style layout with structured information display
Smart Layout RestrictionsWhen using smart layouts, the following restrictions apply:
  • maxSubtitleLines cannot be used at the scene level
  • The layout automatically manages text display and positioning
  • Use either smartLayoutName OR smartLayoutId, not both

Layout Selection Methods

Using Layout Name

The simplest way to select a smart layout is by name:
{
  smartLayoutName: "kinetic"
}

Using Layout ID

For programmatic consistency, you can use the layout ID:
{
  smartLayoutId: "your-layout-id-here"
}
Layout IDs provide stability if layout names change in the future. Use the name for human-readable code and ID for automated systems.

Common Use Cases

Corporate Presentation

{
  smartLayoutName: "modern minimalist",
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "Brian",
      speed: 95,
      amplificationLevel: 0
    }]
  },
  scenes: [{
    story: "Your quarterly results presentation content..."
  }]
}
Result: Professional, clean video perfect for business presentations.

Marketing Campaign

{
  smartLayoutName: "kinetic",
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "Matthew",
      speed: 110,
      amplificationLevel: 0.2
    }]
  },
  scenes: [{
    story: "Introducing our latest product innovation..."
  }]
}
Result: Dynamic, energetic video for product launches and promotions.

Fashion and Lifestyle

{
  smartLayoutName: "chic",
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "Emma",
      speed: 100,
      amplificationLevel: 0
    }]
  },
  scenes: [{
    story: "Discover the latest trends in sustainable fashion..."
  }]
}
Result: Elegant, sophisticated video for lifestyle and fashion brands.

Travel Content

{
  smartLayoutName: "wanderlust",
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "Amy",
      speed: 100,
      amplificationLevel: 0
    }]
  },
  scenes: [{
    story: "Experience the breathtaking views of the Swiss Alps..."
  }]
}
Result: Immersive, travel-inspired video with testimonial-style presentation.

Educational Content

{
  smartLayoutName: "bulletin",
  voiceOver: {
    enabled: true,
    aiVoices: [{
      speaker: "Joanna",
      speed: 90,
      amplificationLevel: 0
    }]
  },
  scenes: [{
    story: "Today we'll explore the fundamentals of machine learning..."
  }]
}
Result: Structured, informational video perfect for tutorials and courses.

Best Practices

Choose the right layout for your content:
  • Modern Minimalist: Business reports, corporate updates, professional tutorials
  • Kinetic: Product launches, social media ads, energetic promotions
  • Chic: Fashion content, luxury brands, lifestyle videos
  • Wanderlust: Travel vlogs, testimonials, storytelling
  • Bulletin: Educational content, news updates, informational videos
Smart layouts work best when paired with AI voice-over:
  • Voice narration enhances the visual storytelling
  • Text and voice complement each other
  • Creates more engaging, professional content
  • Voice speed should match the layout energy
Select layouts based on viewer expectations:
  • B2B Content: Modern Minimalist, Bulletin
  • Consumer Marketing: Kinetic, Chic
  • Social Media: Kinetic, Wanderlust
  • Educational: Bulletin, Modern Minimalist
  • Brand Storytelling: Wanderlust, Chic

Troubleshooting

Problem: API returns error about invalid layout name.Solution:
  • Check spelling and case sensitivity
  • Use exact names: “modern minimalist”, “kinetic”, “chic”, “wanderlust”, “bulletin”
  • Ensure you’re not using both name and ID
  • Remove extra spaces or characters from the name
Problem: API returns error about maxSubtitleLines not being allowed.Solution:
  • Remove maxSubtitleLines from all scene configurations
  • Smart layouts automatically manage text display
  • The layout handles subtitle line formatting
  • Use scene breaks to control text pacing instead
Problem: Video uses a different layout than expected.Solution:
  • Verify the layout name spelling is correct
  • Double-check you’re not using both name and ID
  • Ensure the parameter is at the video level, not scene level
  • Review the available layout options in this guide

Next Steps

Enhance your smart layout videos with these features:

API Reference

For complete technical details, see: