Skip to content

Assets & presets

Two kinds of tool here. The capabilities produce new material — a music bed, a sting, a shot. The listings tell you what the account already has, which is how you turn “use my newsroom brand” into an id the other tools accept.

These return an asset. They do not place it — putting it in the video is an edit_video operation, which keeps “make something” and “change the cut” as separate, individually reversible steps.

generate_music

Generate a background music bed from a description of the vibe (e.g. "hype, upbeat electronic"). Returns an audio file to place with edit_video — use it to change a finished video's music. Reuses a cached bed when one matches, so repeats are cheap.

ParameterTypeDescription
prompt requiredstringThe feel of the track in a few words — genre, energy, instrumentation. No lyrics.
duration_secondsnumberRoughly how long it needs to play. Defaults to 30.
job_idstringThe video job this is for, when known.

generate_sound_effect

Generate a short sound effect from a description (e.g. "whoosh on a hard cut", "UI click"). Returns an audio file to place with edit_video.

ParameterTypeDescription
prompt requiredstringWhat the sound should be.
duration_secondsnumberHow long it should run.
sfx_typestringRough category, e.g. "transition", "impact", "whoosh".
job_idstring

find_broll

Find one stock clip or still for a description, from the same libraries the pipeline uses. Use it when the user wants different b-roll and hasn't uploaded their own footage. Returns a file to place with edit_video.

ParameterTypeDescription
prompt requiredstringWhat the shot should show.
source_typestringMoving footage or a still. Defaults to video. One of: video, image.
aspect_ratiostringThe video's aspect ratio, so the search asks for the right orientation. One of: 9:16, 16:9, 1:1.

list_presets

List the user's saved presets/templates of a given type (name + id + which is the default). Use before applying a brand kit or caption preset by name.

ParameterTypeDescription
type requiredstringOne of: brand_kits, captions, voiceovers, video_templates, script_templates, speaker_styles.

list_voices

List available AI narration voices (ElevenLabs catalogue).

Takes no parameters.

The ElevenLabs catalogue available to the account. Pass a voice_id from here to create_video_from_script to choose the narrator for an AI-voiceover video.