AI Storyboard

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"; // Replace with your actual API key

const SCRIPT =
  "Creating videos used to take hours. " +
  "Pictory turns a script into a finished video in minutes. " +
  "Paste your text, pick a voice, and let the AI handle the visuals. " +
  "Try it today and publish your first video before lunch.";

async function renderAiStoryboard() {
  try {
    console.log("Rendering AI storyboard...");

    const response = await axios.post(
      `${API_BASE_URL}/v2/video/storyboard/render`,
      {
        videoName: "ai_storyboard_from_script",
        aiStoryboard: { enabled: true },
        aspectRatio: "16:9",
        voiceOver: {
          enabled: true,
          aiVoices: [{ speaker: "Brian", speed: 100 }],
        },
        scenes: [
          {
            story: SCRIPT,
            // Optional: one designed scene per sentence is the default
            createSceneOnEndOfSentence: true,
          },
        ],
      },
      {
        headers: {
          "Content-Type": "application/json",
          Authorization: API_KEY,
        },
      }
    );

    const jobId = response.data.data.jobId;
    console.log("Job ID:", jobId);
    return jobId;
  } catch (error) {
    console.error("Error:", error.response?.data || error.message);
    throw error;
  }
}

import requests
import time

API_BASE_URL = 'https://api.pictory.ai/pictoryapis'
API_KEY = 'YOUR_API_KEY'  # Replace with your actual API key

SCRIPT = (
    "Creating videos used to take hours. "
    "Pictory turns a script into a finished video in minutes. "
    "Paste your text, pick a voice, and let the AI handle the visuals. "
    "Try it today and publish your first video before lunch."
)

def render_ai_storyboard():
    print("Rendering AI storyboard...")

    response = requests.post(
        f'{API_BASE_URL}/v2/video/storyboard/render',
        json={
            'videoName': 'ai_storyboard_from_script',
            'aiStoryboard': {'enabled': True},
            'aspectRatio': '16:9',
            'voiceOver': {
                'enabled': True,
                'aiVoices': [{'speaker': 'Brian', 'speed': 100}]
            },
            'scenes': [
                {
                    'story': SCRIPT,
                    # Optional: one designed scene per sentence is the default
                    'createSceneOnEndOfSentence': True
                }
            ]
        },
        headers={
            'Content-Type': 'application/json',
            'Authorization': API_KEY
        }
    )
    response.raise_for_status()

    job_id = response.json()['data']['jobId']
    print(f'Job ID: {job_id}')
    return job_id

async function waitForVideo(jobId) {
  console.log("\nMonitoring render...");

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

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

    if (data.status === "completed") {
      console.log("\nVideo URL:", data.videoURL);
      console.log("Share URL:", data.videoShareURL);
      console.log("Duration (s):", data.videoDuration);
      return data;
    }
    if (data.status === "failed") {
      throw new Error("Render failed: " + JSON.stringify(statusResponse.data));
    }

    // Poll every 10-30 seconds
    await new Promise(resolve => setTimeout(resolve, 15000));
  }
}

// Run the complete workflow
renderAiStoryboard()
  .then(jobId => waitForVideo(jobId))
  .then(() => console.log("\nDone!"))
  .catch(error => console.error("Error:", error));

def wait_for_video(job_id):
    print("\nMonitoring render...")

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

        data = response.json()['data']
        print(f"Status: {data['status']} Progress: {data.get('progress')}")

        if data['status'] == 'completed':
            print(f"\nVideo URL: {data['videoURL']}")
            print(f"Share URL: {data['videoShareURL']}")
            print(f"Duration (s): {data['videoDuration']}")
            return data
        if data['status'] == 'failed':
            raise Exception(f'Render failed: {response.json()}')

        # Poll every 10-30 seconds
        time.sleep(15)

# Run the complete workflow
if __name__ == '__main__':
    job_id = render_ai_storyboard()
    wait_for_video(job_id)
    print("\nDone!")

const response = await axios.post(
  `${API_BASE_URL}/v2/video/storyboard/render`,
  {
    aiStoryboard: { enabled: true },
    aspectRatio: "16:9",
    voiceOver: {
      enabled: true,
      aiVoices: [{ speaker: "Brian" }],
    },
    scenes: [
      {
        brief: {
          prompt: "Create a 1 minute explainer video that simplifies video creation for beginners.",
          videoGoal: "Explainer",
          tone: "friendly",
          duration: 60,
        },
      },
    ],
  },
  {
    headers: {
      "Content-Type": "application/json",
      Authorization: API_KEY,
    },
  }
);

console.log("Job ID:", response.data.data.jobId);

response = requests.post(
    f'{API_BASE_URL}/v2/video/storyboard/render',
    json={
        'aiStoryboard': {'enabled': True},
        'aspectRatio': '16:9',
        'voiceOver': {
            'enabled': True,
            'aiVoices': [{'speaker': 'Brian'}]
        },
        'scenes': [
            {
                'brief': {
                    'prompt': 'Create a 1 minute explainer video that simplifies video creation for beginners.',
                    'videoGoal': 'Explainer',
                    'tone': 'friendly',
                    'duration': 60
                }
            }
        ]
    },
    headers={
        'Content-Type': 'application/json',
        'Authorization': API_KEY
    }
)
response.raise_for_status()

print(f"Job ID: {response.json()['data']['jobId']}")