Join videos

Join two or more videos end-to-end into a single file. Async — returns 202 with a pending job; poll GET /tool_jobs/{uid} until status is completed or failed.

post/tools/concat_videos

Request body

video_urlsstring[] required

Two or more URLs in play order

transition'none' | 'fade' | 'dissolve' | 'wipeleft' | 'slideleft'

How each clip flows into the next. Defaults to none

transition_durationnumber

Only used when transition is set. Defaults to 1

widthinteger

Defaults to the first video's width, capped at 1920 on the long edge

heightinteger

Defaults to the first video's height, capped at 1080 on the short edge

fpsinteger

Defaults to the highest frame rate among the inputs, capped at 60

metadatastring

Arbitrary metadata string stored with the tool run

Response

Tool run accepted

uidstring

tool'concat_videos'

status'pending' | 'running' | 'completed' | 'failed'

pending → running → completed / failed

progressinteger

0-100 job progress, 100 once completed

inputsobject

Inputs the job was created with

metadatastring nullable

Arbitrary metadata string round-tripped from the create request

selfstring uri

created_atstring date-time

completed_atstring date-time nullable

error_messagestring nullable

Human-readable failure reason (only present on failed jobs)

Changes

No recorded changes to this endpoint across all 1 revision of this API.