First of all go to the 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 and get an API key.

​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

{
  "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": {}
}

​Handle the Response

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

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

​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.

​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.