Combine video clips into a new video

Combine multiple existing video clips (previously generated via AutoReel) into a single combined video. All clips must share the same orientation and resolution.

Authentication

Authorization: Bearer <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

FieldTypeDescription
uuidstringUUID of the new combined video
statusstringStatus of the new video (queued, in_progress, complete)
video_urlstringEmpty initially; will be populated when processing is complete
video_clipsVideoClip[]List of included clips in the combined video
orientationstringOrientation of the combined video (landscape or portrait)
resolutionstringResolution of the combined video (720p or 1080p)

video_clips[] object

FieldTypeDescription
uuidstringUUID of the individual clip used
image_urlstringURL of the image associated with the clip
clip_urlstringURL of the video clip
camera_motionstringCamera motion used
orientationstringOrientation of the clip
resolutionstringResolution of the clip
ai_enginestringAI Engine used to make the clip
Language
Credentials
Header
Click Try It! to start a request and see the response here!