Skip to content

Create videos programmatically in the cloud from NodeJS: add watermarks, resize videos, create slideshows, add soundtrack, voice-over with text-to-speech (TTS), text animations.

License

Notifications You must be signed in to change notification settings

JSON2Video/json2video-nodejs-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Note: Updated for API v2.0

Create videos programmatically in Node JS

Create and edit videos: add watermarks, resize videos, create slideshows, add soundtrack, automate the creation of videos in multiple languages, add voice-over, add text animations.

JSON2Video is a video editing API that simplifies creating, editing and customising videos programmatically. Its dead simple approach, close to the web development mindset, makes it the ultimate solution for developers that want to create or customise videos in an automated way.

Additionally, the simple integration of real HTML5+CSS elements, the already built-in text animations and voice generation (TTS) converts JSON2Video in the best solution in its category.

Use cases

  • Automate the production of promotional videos for your e-commerce products
  • Automate publication of social media videos created directly from your news feed
  • Customize your advertising campaigns with different images, videos, texts and create tens or hundreds of different options
  • From weather forecasts to traffic bulletins or financial reports, if you have a data source you can create an audiovisual experience
  • Convert your text, pictures and information into engaging videos of your real estate properties
  • Add watermarks, bumpers, titles; Concatenate different videos into one; Add voice-over or music; Create photo slideshows; …

Get your FREE API Key

JSON2Video is free to use. Get your API Key at JSON2Video.com

Documentation

The API Specification will provide you with all the details of the JSON payload and the endpoints.

For a step by step guide, read the Tutorial that will introduce you through all features with code examples.

NodeJS SDK installation

The SDK has no external dependencies on other packages.

  1. Open the terminal and cd to your project directory
  2. Use npm:
npm install json2video-sdk

Hello world

JSON2Video makes video creation easy as a piece of cake:

    const {Movie, Scene} = require("json2video-sdk");
        
    async function main() {
        // Create a new movie
        let movie = new Movie;

        // Set your API key
        // Get your free API key at https://json2video.com
        movie.setAPIKey(YOUR_API_KEY);

        // Set movie quality: low, medium, high
        movie.set("quality", "high");

        // Generate a video draft 
        movie.set("draft", true);

        // Create a new scene
        let scene = new Scene;

        // Set the scene background color
        scene.set("background-color",  "#4392F1");

        // Add a text element printing "Hello world" in a fancy way (style 003)
        // The element is 10 seconds long and starts 2 seconds from the scene start
        scene.addElement({
            type: "text",
            style: "003",
            text: "Hello world",
            duration: 10,
            start: 2
        });

        // Add the scene to the movie
        movie.addScene(scene);

        // Call the API and render the movie
        let render = await movie.render();
        console.log(render);

        // Wait for the movie to finish rendering
        await movie
            .waitToFinish((status) => {
                console.log("Rendering: ", status.movie.status, " / ", status.movie.message);
            })
            .then((status) => {
                console.log("Response: ", status);
                console.log("Movie is ready: ", status.movie.url);
            })
            .catch((err) => {
                console.log("Error: ", err);
            });
    }

    main();

This is the resulting video:

https://assets.json2video.com/sites/github/hello-world.mp4