JSON2Video

https://json2video.com/docs/v2
Admin
JSON2Video is an API for programmatic video creation, enabling users to generate videos from JSON...
Tokens:2,896
Snippets:10
Trust Score:8.8
Update:1 year ago
Show doc for...
Tokens:
Raw
### JSON2Video Troubleshooting Guide

Source: https://json2video.com/docs/v2/index

This section addresses common issues encountered when using the JSON2Video API and its integrations. It provides solutions for authentication problems and challenges related to AI asset generation.

```APIDOC
Troubleshooting:
  - Authentication: Guidance on resolving issues related to API key verification and access.
  - AI Asset Generation: Solutions for problems encountered during the creation of AI-generated video assets.
```

--------------------------------

### JSON2Video API - Core Concepts and Usage

Source: https://json2video.com/docs/v2/index

This section outlines the fundamental concepts of the JSON2Video API, explaining how to interact with it through both direct API calls and no-code tools. It covers the basic workflow, from creating your first movie to checking render status and common integration patterns.

```APIDOC
JSON2Video API Overview:
  Purpose: Enables programmatic video creation and manipulation using JSON configurations.
  Usage Methods:
    - Direct API: Interact with the API endpoints for full control.
    - No-code Tools: Utilize pre-built modules for common video editing tasks.

Getting Started:
  - Create Your First Movie: Guide to generating a basic video.
  - Checking Render Status: How to monitor the progress of video renders.
  - Common Patterns: Reusable workflows and configurations for video creation.
```

--------------------------------

### JSON2Video SDKs and Pricing

Source: https://json2video.com/docs/v2/index

Information regarding the Software Development Kits (SDKs) available for integrating JSON2Video into custom applications. This section also details the pricing structure, including credit consumption and available plans.

```APIDOC
SDKs:
  - Availability: Information on SDKs for various programming languages to interact with the JSON2Video API.

Pricing:
  - Credit Consumption: Details on how API usage translates into credit usage.
  - Plans: Overview of different subscription tiers and their features.
  - FAQ: Frequently asked questions related to billing and usage.
```

--------------------------------

### JSON2Video No-Code Integrations - Make.com Modules

Source: https://json2video.com/docs/v2/index

This documentation details various no-code modules available for integration with Make.com, simplifying common video creation and editing tasks. These modules abstract complex API calls into user-friendly actions.

```APIDOC
Make.com Modules:
  - Create Slideshow with Audio: Generates a slideshow video from images and includes background audio.
  - Concat a List of Videos with Background Audio: Merges multiple video clips into a single video with specified background audio.
  - Toolbox:
    - Add Voiceover to Video or Image: Integrates voiceover narration into video or image content.
    - Merge Audio and Video: Combines separate audio and video streams.
    - Trim a Video: Allows for precise cutting and shortening of video clips.
    - Quote Video: Extracts specific segments from a video.
    - Social Media Reel: Creates short, engaging video content optimized for social media platforms.
```

--------------------------------

### AI Integrations

Source: https://json2video.com/docs/v2/index

Information on integrating with AI services, specifically ElevenLabs for text-to-speech capabilities.

```APIDOC
APIDOC:
  AI Integrations:
    ElevenLabs:
      Description: Use ElevenLabs for high-quality AI voice generation.
      Usage:
        Include a "voice" element in your JSON scene.
        `kind: "voice"
        text: "This is the text to be spoken."
        voice_provider: "elevenlabs"
        voice_id: "21m00Tcm4Tlv7Kqzh7Qf"  // Example ElevenLabs voice ID`
      Authentication:
        Requires an ElevenLabs API key, which should be configured in your JSON2Video account settings.
```

--------------------------------

### Make.com Integration - Add Automatic Subtitles

Source: https://json2video.com/docs/v2/index

Demonstrates how to use the JSON2Video module within Make.com (formerly Integromat) to automatically add subtitles to a video.

```APIDOC
APIDOC:
  No-code Integrations:
    Make.com Modules:
      Add Automatic Subtitles to a Video:
        Description: This module takes a video and generates subtitles for it, adding them as an overlay.
        Input:
          - Video: The video file or URL to process.
          - Subtitle Language: The language for subtitle generation (e.g., 'en', 'es').
        Output:
          - Processed Video: The video with added subtitles.
        Scenario Example:
          1. Trigger: Watch for new videos in a cloud storage bucket.
          2. JSON2Video Module: 'Add Automatic Subtitles to a Video' - Pass the video and desired language.
          3. Action: Save the processed video to another location or send a notification.
```

--------------------------------

### Export Options

Source: https://json2video.com/docs/v2/index

Covers various methods for exporting generated videos, including webhooks for real-time notifications and direct uploads to FTP/SFTP servers.

```APIDOC
APIDOC:
  Exports:
    Webhooks:
      Description: Receive real-time notifications about video processing status and completion.
      Configuration:
        Provide a webhook URL in your API request or dashboard settings.
        `exports: { webhooks: ["https://your-domain.com/webhook-receiver"] }`
      Payload:
        The webhook payload will contain details about the video job, including status, progress, and output URL.

    Uploading to FTP/SFTP:
      Description: Automatically upload generated videos to a remote FTP or SFTP server.
      Configuration:
        Provide FTP/SFTP server details in your JSON2Video account settings.
        `exports: { ftp: { host: "ftp.example.com", username: "user", password: "pass", path: "/videos/" } }`

    Email notification:
      Description: Receive an email notification upon video completion.
      Configuration:
        Ensure your account email is set. The notification will be sent to this address.
```

--------------------------------

### JSON2Video API Endpoints

Source: https://json2video.com/docs/v2/index

This section details the available API endpoints for interacting with the JSON2Video service. It covers the primary endpoints for creating and managing video content.

```APIDOC
APIDOC:
  Movies:
    POST /movies
      Description: Creates a new movie based on provided JSON data.
      Request Body: JSON object defining the movie structure (scenes, elements, etc.).
      Response: Details of the created movie, including its ID and status.
    GET /movies/{movie_id}
      Description: Retrieves the status and details of a specific movie.
      Parameters:
        movie_id: The unique identifier of the movie.
      Response: Movie status, progress, and output URL if available.
    GET /movies
      Description: Retrieves a list of all movies created by the user.
      Response: An array of movie objects.
```

--------------------------------

### Mastering Video Properties

Source: https://json2video.com/docs/v2/index

Details advanced mastering options for controlling video rendering, including timing, layering, positioning, variables, expressions, and conditional elements.

```APIDOC
APIDOC:
  Mastering:
    Duration and timing:
      Elements can have explicit start and end times within a scene.
      `timing: { start: 1.5, end: 5.0 }`

    Layering:
      Elements are rendered in the order they appear in the `elements` array. Later elements appear on top.

    Positioning:
      Elements can be positioned using `position: { x: 0.5, y: 0.5 }` where values are normalized (0 to 1).

    Variables:
      Define variables in the movie JSON to be reused.
      `variables: { title_text: "My Awesome Video" }`
      Use variables within element properties: `content: "${title_text}"`

    Expressions:
      Use JavaScript-like expressions for dynamic properties.
      `position.x: "time * 0.1"`

    Conditional elements:
      Control element visibility based on conditions.
      `condition: "time > 3.0 && variable.user_count > 10"`

    Dynamic number of scenes:
      Generate scenes programmatically based on data.
```

--------------------------------

### JSON Syntax for Video Elements

Source: https://json2video.com/docs/v2/index

Defines the JSON structure required to describe various elements within a video, including images, video clips, text, audio, and more. This syntax is crucial for programmatic video generation.

```APIDOC
APIDOC:
  JSON Syntax:
    Movie:
      type: "movie"
      scenes: [Scene]
      duration: number (optional)
      output_format: string (optional, e.g., "mp4")

    Scene:
      type: "scene"
      elements: [Element]
      duration: number (optional)
      background_color: string (optional)

    Element:
      type: "element"
      kind: string (e.g., "image", "video", "text", "audio", "component", "audiogram", "voice", "subtitles")
      source: string (URL or path to the media)
      duration: number (optional)
      position: { x: number, y: number } (optional)
      size: { width: number, height: number } (optional)
      opacity: number (optional)
      timing: { start: number, end: number } (optional)

    Image Element:
      kind: "image"
      source: "url_to_image.jpg"

    Video Element:
      kind: "video"
      source: "url_to_video.mp4"

    Text Element:
      kind: "text"
      content: "Hello, World!"
      font: string (optional)
      font_size: number (optional)
      color: string (optional)

    Audio Element:
      kind: "audio"
      source: "url_to_audio.mp3"
      volume: number (optional)

    Voice Element:
      kind: "voice"
      text: "Speech content."
      voice_provider: string (e.g., "elevenlabs")
      voice_id: string (optional)

    Subtitles Element:
      kind: "subtitles"
      source: "url_to_srt_file.srt"
      position: { x: number, y: number } (optional)
      font_size: number (optional)
      color: string (optional)
```
Tokens:
Raw