# Use the Video AIditor API to Create the Video

Hope you are enjoying editing with the VideoAIditor. In this guide we will be guiding you to use the API to create the video using a template video.

First of all go to the [editor.videoaiditor.com](https://editor.videoaiditor.com) and create a video and export that as JSON. We will be using that JSON as a template for future videos.

Now go to [videoaiditor.com](https://videoaiditor.com) and get an API key.

[**​**](https://docs.videoaiditor.com/guides/How%20to%20use%20the%20API#use-the-api-to-create-the-video)Send your video template JSON, created via the editor, and get the link for further editing, use the following API endpoint:

Add your API key to the request header as follows:

* `x-api-key: YOUR_API_KEY`
    

Send a `POST` request to `https://api.videoaiditor.com/v1/videos` with the JSON body and the appropriate headers.

## **Request Body Example**

```json
{
  "metadata": {
    "name": "<string>",
    "backgroundColor": "<string>",
    "duration": 123,
    "fps": 123,
    "canvas": {
      "width": 123,
      "height": 123
    }
  },
  "clips": [
    {
      "type": "<string>",
      "name": "<string>",
      "source": "<string>",
      "timeFrame": {
        "start": 123,
        "end": 123
      },
      "position": {
        "x": 123,
        "y": 123,
        "z": 123
      },
      "transform": {
        "scale": {
          "x": 123,
          "y": 123
        },
        "rotation": 123
      },
      "size": {
        "width": 123,
        "height": 123
      },
      "effects": {
        "opacity": 0.5
      },
      "textProperties": {
        "content": "<string>",
        "fontSize": 123,
        "fontWeight": 123,
        "fontFamily": "<string>",
        "color": "<string>",
        "backgroundColor": "<string>",
        "textAlign": "<string>",
        "fontStyle": "<string>",
        "lineHeight": 123,
        "underline": true
      }
    }
  ],
  "additional": {}
}
```

## [**​**](https://docs.videoaiditor.com/guides/How%20to%20use%20the%20API#handle-the-response)**Handle the Response**

Once you send the request, the API will return a response that includes data in the following format:

```json
{
  "data": {
    "metadata": {
      "redirectUrl": "https://videoaiditor.com/editor/{unique-id}",
        ...
    }
    ...
    ...
  }
}
```

### [**​**](https://docs.videoaiditor.com/guides/How%20to%20use%20the%20API#important-save-the-redirecturl)**Important: Save the** `redirectUrl`

The response will contain a `redirectUrl` field in the metadata. **Save this URL** — it’s a special link that will allow you to continue editing the video.

* The URL is **public** but only accessible to users who have the link.
    
* You can share this URL with others to allow them to edit the video. Since it’s a presigned URL, no one else will be able to access it without the exact link.
    

## [**​**](https://docs.videoaiditor.com/guides/How%20to%20use%20the%20API#final-notes)**Final Notes**

* **Security:** Be cautious when sharing the `redirectUrl` since it provides direct access to that video in video editor.
    
* **Public Access:** Ensure the asset URLs you provide in the JSON are publicly accessible. If they are private or restricted, the video may not load correctly when editing.
    
* **API Key:** Keep your API key secure. Do not share it in public forums or expose it in client-side code.