Authentication

Authorization: <YOUR_API_KEY>

Request Body Fields

Field	Type	Required	Description
`video_clip_uuids`	string[]	Yes	List of UUIDs of previously created video clips (max: 20). Note: all video_clips must be made with the same `ai_engine`
`orientation`	string	Yes	Must be `landscape` or `portrait`. All clips must match this.
`resolution`	string	Yes	Must be `720p` or `1080p`. All clips must match this.
`audio_url`	string	No	Public URL to optional background audio (≤ 10 MB)

Example Request Body

{
  "video_clip_uuids": [
    "b9f4201e-ef9e-4de0-9f3c-b958bd90db00",
    "db1e97f0-b77f-455a-b5d7-83f8a5beed71"
  ],
  "orientation": "landscape",
  "resolution": "720p"
}

Successful Response

Field	Type	Description
`uuid`	`string`	UUID of the new combined video
`status`	`string`	Status of the new video (`queued`, `in_progress`, `complete`)
`video_url`	`string`	Empty initially; will be populated when processing is complete
`video_clips`	`VideoClip[]`	List of included clips in the combined video
`orientation`	`string`	Orientation of the combined video (`landscape` or `portrait`)
`resolution`	`string`	Resolution of the combined video (`720p` or `1080p`)

`video_clips[]` object

Field	Type	Description
`uuid`	`string`	UUID of the individual clip used
`image_url`	`string`	URL of the image associated with the clip
`clip_url`	`string`	URL of the video clip
`camera_motion`	`string`	Camera motion used
`orientation`	`string`	Orientation of the clip
`resolution`	`string`	Resolution of the clip
`ai_engine`	string	AI Engine used to make the clip

201New combined video created