BAbannerbear

Join videos

Changed on

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

  • Base URL
    https://api.bannerbear.com/v5
  • Auth
    HTTP bearer

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