Multi-Level Voice-Over

npm install axios

pip install requests

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();

import requests
import time
import json

API_BASE_URL = 'https://api.pictory.ai/pictoryapis'
API_KEY = 'YOUR_API_KEY'

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

def create_video_with_multilevel_voiceover():
    try:
        print("Creating video with multi-level voice-over...")

        response = requests.post(
            f'{API_BASE_URL}/v2/video/storyboard/render',
            json={
                '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
            }
        )
        response.raise_for_status()

        job_id = response.json()['data']['jobId']
        print("✓ Video creation started!")
        print(f"Job ID: {job_id}")

        # Monitor progress
        print("\nMonitoring video creation...")
        job_completed = False
        job_result = None

        while not job_completed:
            status_response = requests.get(
                f'{API_BASE_URL}/v1/jobs/{job_id}',
                headers={'Authorization': API_KEY}
            )
            status_response.raise_for_status()

            status = status_response.json()['data']['status']
            print(f"Status: {status}")

            if status == 'completed':
                job_completed = True
                job_result = status_response.json()
                print("\n✓ Video is ready!")
                print(f"Video URL: {job_result['data']['videoURL']}")
            elif status == 'failed':
                raise Exception(f"Video creation failed: {status_response.json()}")

            time.sleep(5)

        return job_result

    except requests.exceptions.RequestException as error:
        print(f"Error: {error}")
        raise

if __name__ == '__main__':
    create_video_with_multilevel_voiceover()