Skip to navigation
Video ToolsEdit

Media · Video · Auto-add B-roll footage to a video

View as Markdown

Analyzes the video or script and automatically inserts relevant B-roll clips. Provide either media_url (existing video) or asset (asset ID). Returns a task_id.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
titlestringRequired

Title or topic of the video (used to source relevant B-roll).

media_urlstringOptional

URL of the source video to add B-roll to.

assetstringOptional

Asset ID of the source video (alternative to media_url).

language_codestringOptional

Language of the video content (e.g. "en", "es"). Default "en".

should_exportbooleanOptional
Whether to export the final video. Default true.

Response

Async task queued.
task_idstringOptional

Poll GET /api/v1/tasks/{task_id} until SUCCESS or FAILURE.