Bring your own API keys

When using JSON2Video API, you can use your own API keys for the AI models. This is useful if you want to use a specific customization of an AI model (like your cloned voice) or if you want to get charged for the AI models usage instead of using the JSON2Video managed service.

How to setup your own API keys

To use your own API keys, you must create a Connection in your JSON2Video dashboard.

For example, if you want to use your own API keys for ElevenLabs you would do this:

• Create a Connection with a relevant ID for you (like my-elevenlabs-apikey)
• Select apikey as the type of connection
• Enter your API Key
• Save

You can repeat this process for any other API Key you want to use.

How to use your own API keys in your JSON2Video API requests

To use your own API keys in your JSON2Video API requests, you need to set the connection property to the ID of the Connection you created.

For example, if you want to use your own API keys for ElevenLabs you would do this:

{
    "resolution": "full-hd",
    "scenes": [
        {
            "elements": [
                {
                    "type": "voice",
                    "model": "elevenlabs",
                    "connection": "my-elevenlabs-apikey",
                    "text": "That's one small step for a man, one giant leap for mankind.",
                    "voice": "Brian"
                }
            ]
        }
    ]
}

require 'vendor/autoload.php';

use JSON2Video\Movie;
use JSON2Video\Scene;

// Create and initialize the movie object
$movie = new Movie;
$movie->setAPIKey(YOUR_API_KEY);
$movie->resolution = 'full-hd';

// Create the scenes of the movie

// Create SCENE 1
$scene1 = new Scene;
$scene1->addElement([
	'type' => 'voice',
	'model' => 'elevenlabs',
	'connection' => 'my-elevenlabs-apikey',
	'text' => 'That\'s one small step for a man, one giant leap for mankind.',
	'voice' => 'Brian'
]);
$movie->addScene($scene1);

// Finally, render the movie
$movie->render();

// Wait for the movie to be rendered
$movie->waitToFinish();

let movie = new Movie;
movie.setAPIKey(YOUR_API_KEY);
movie.set("resolution", "full-hd");

// Create the scenes of the movie

// Create SCENE 1
let scene1 = new Scene;
scene1.addElement({
	"type": "voice",
	"model": "elevenlabs",
	"connection": "my-elevenlabs-apikey",
	"text": "That's one small step for a man, one giant leap for mankind.",
	"voice": "Brian"
});
movie.addScene(scene1);

// Finally, render the movie
movie.render();

// Wait for the movie to be rendered
movie.waitToFinish();

Published on January 13th, 2025

Author

Joaquim Cardona Senior Internet business executive with more than 20 years of broad experience in Internet business, media sector, digital marketing, online video and mobile technologies.