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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Authentication

Authorization: <YOUR_API_KEY>


Request Body Fields

FieldTypeRequiredDescription
video_clip_uuidsstring[]Yes

List of UUIDs of previously created video clips. Maximum count depends on your plan's per-video clip limit.

Note: all video_clips must be made with the same ai_engine

orientationstringYesMust be landscape or portrait. All clips must match this.
resolutionstringYesMust be 720p or 1080p. All clips must match this.
audio_urlstringNoPublic URL to optional background audio (≤ 10 MB)
projectstringNoUUID of a project to link the combined video to. Omit it to use your API key's default project.

Example Request Body

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

Successful Response

FieldTypeDescription
uuidstringUUID of the new combined video
projectstringUUID of the project this video was linked to — either the one you passed in project, or your API key's default project if you didn't.
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)
ai_enginestringAI Engine used (v24 or v25)

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 (v24 or v25)
vfxobject | nullVFX applied to that clip (mirrors the original create_video input), or null if none.

Body Params
video_clip_uuids
array of uuids
required

List of UUIDs of previously created video clips. Maximum count depends on your plan's per-video clip limit.

video_clip_uuids*
string
enum
required

Must be landscape or portrait. All clips must match this.

Allowed:
string
enum
required

Must be 720p or 1080p. All clips must match this.

Allowed:
uri

Publicly accessible URL of the audio (≤ 10 MB).

uuid

UUID of a project to link the combined video to. Omit it to use your API key's default project.

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json