Getting Started with JSON to Video

Step 1: The Building Blocks 🧱

Let's break down what makes a video

Every video needs three main things:

Images - The pictures you want to show
Voice - The words you want people to hear
Background Music - The music that plays along

Step 2: Making Your First Video 🎬

Here's a simple example to get you started

Here's what you need to tell us:

{
  "type": "ImageVideo",
  "data": {
    "background_url": "your-music-url.mp3",
    "voice_url": "your-voice-url.mp3",
    "media_list": [
      {"type": "image", "url": "your-image-1.jpg"},
      {"type": "image", "url": "your-image-2.jpg"}
    ],
    "settings": {
      "aspect_ratio": "9:16",
      "background_volume": 0.15,
      "voice_volume": 1.0
    }
  }
}

Let's break this down:

type: Just tell us it's an "ImageVideo"
background_url: Where your background music is
voice_url: Where your voice recording is
media_list: A list of all your images

Step 3: Making it Pretty 🎨

Let's add some style to your video

You can make your video look exactly how you want:

"settings": {
  "aspect_ratio": "9:16",    // For TikTok/Reels
  "background_volume": 0.15,  // Quiet background music
  "voice_volume": 1.0,       // Clear voice
  "font_size": 120,          // Big text
  "stroke_color": "green",   // Green outline
  "stroke_width": 10         // Thick outline
}

Fun things you can change:

aspect_ratio: "9:16" for TikTok/Reels, "16:9" for YouTube, "1:1" for Instagram
font_size: How big you want your text (30-150)
stroke_color: The color of your text outline
background_volume: How loud the music should be (0.0-1.0)

Step 4: Adding Captions 💬

Make your video accessible with text

Add captions to your video like this:

"transcripts": [
  {
    "words": "Once Upon A Time",
    "start": 0,
    "end": 0.98
  },
  {
    "words": "Lived A Little Monitor",
    "start": 0.98,
    "end": 1.58
  }
]

Each caption needs:

words: What you want to show
start: When to start showing it (in seconds)
end: When to stop showing it (in seconds)

A Complete Example 🌟

Here's everything put together

Here's a full example of a bedtime story video:

{
  "type": "ImageVideo",
  "data": {
    "background_url": "https://storage.googleapis.com/bedtimestory-yt/music.mp3",
    "media_list": [
      {"type": "image", "url": "https://storage.googleapis.com/bedtimestory-yt/image-1"},
      {"type": "image", "url": "https://storage.googleapis.com/bedtimestory-yt/image-2"}
    ],
    "voice_url": "https://storage.googleapis.com/bedtimestory-yt/voice",
    "transcripts": [
      {"words": "Once Upon A Time", "start": 0, "end": 0.98},
      {"words": "Lived A Little Monitor", "start": 0.98, "end": 1.58}
    ],
    "settings": {
      "aspect_ratio": "9:16",
      "background_volume": 0.15,
      "voice_volume": 1.0,
      "font_size": 120,
      "stroke_color": "green",
      "stroke_width": 10
    }
  }
}

Ready to Try? 🚀

Let's make your first video!

To get started:

Get your API key from the dashboard
Prepare your images, voice, and background music
Copy our example and replace the URLs with yours
Send it to our API and watch the magic happen!