enrich

Add a B-roll segment (Pexels id or https URL)

Downloads the clip to the server (-an, short side 720) and appends it to edit.broll of the orientation. start/end absolute seconds inside the clip. Returns the full B-roll list.

post/api/clips/{id}/broll

Request

  • Base URL: https://cliponit.app
  • URL: https://cliponit.app/api/clips/{id}/broll
  • Auth: one of:
    • HTTP bearer
    • API key in cookie session
    • OAuth 2 (authorization code, authorization URL https://cliponit.app/oauth/authorize, token URL https://cliponit.app/oauth/token, scopes: clips)

Path parameters

idstring uuid required
Example:6f1c2d6e-3b1a-4c0f-9a0e-2f5d1c7b8e90

Clip id (UUID)

Query parameters

orientation'vertical' | 'horizontal' | 'square' | 'portrait45'

vertical = 9:16 1080x1920 (TikTok/Reels/Shorts), horizontal = 16:9 1920x1080 (YouTube), square = 1:1 1080x1080 (feed), portrait45 = 4:5 1080x1350 (Instagram feed). auto-reframe supports vertical|horizontal only.

Which edit/export: vertical (9:16, default), horizontal (16:9), square (1:1) or portrait45 (4:5). Each clip has one independent edit per orientation.

Request body

startnumber required
endnumber required
pexels_idinteger
video_urlstring uri

https only; alternative to pexels_id

querystring

Search query to remember (informational)

Response

B-roll list

idstring required
startnumber required
endnumber required
src'pexels' | 'upload' required
pathstring required

Server path under data/broll/ (send back unchanged)

preview_urlstring nullable
querystring nullable

Changes

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