Multi-Level Voice-Over

npm install axios

import axios from "axios";

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

// Different text for different scenes
const INTRO_TEXT = "Welcome to our comprehensive guide on AI in education.";
const MAIN_TEXT = "AI is transforming how educators create content, automate workflows, and personalize learning experiences.";
const OUTRO_TEXT = "Thank you for watching. Subscribe for more insights.";

async function createVideoWithMultiLevelVoiceOver() {
  try {
    console.log("Creating video with multi-level voice-over...");

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

        // Video-level voice-over (default for all scenes)
        voiceOver: {
          enabled: true,
          aiVoices: [
            {
              speaker: "Brian",
              speed: 100,           // Normal speed
              amplificationLevel: 0, // Normal volume
            },
          ],
        },

        scenes: [
          {
            story: INTRO_TEXT,
            createSceneOnNewLine: false,
            createSceneOnEndOfSentence: false,

            // Scene-specific voice-over (slower and louder for emphasis)
            voiceOver: {
              enabled: true,
              aiVoices: [
                {
                  speaker: "Brian",
                  speed: 85,           // 15% slower for emphasis
                  amplificationLevel: 0.3, // Slightly louder
                },
              ],
            },
          },
          {
            story: MAIN_TEXT,
            createSceneOnNewLine: false,
            createSceneOnEndOfSentence: false,
            // No scene-level voice-over = uses video-level default
          },
          {
            story: OUTRO_TEXT,
            createSceneOnNewLine: false,
            createSceneOnEndOfSentence: false,

            // Different scene-level settings for outro
            voiceOver: {
              enabled: true,
              aiVoices: [
                {
                  speaker: "Brian",
                  speed: 90,           // Slightly slower
                  amplificationLevel: 0.1, // Slightly louder
                },
              ],
            },
          },
        ],
      },
      {
        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 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;
  }
}

createVideoWithMultiLevelVoiceOver();