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.
Capabilities
Section titled “Capabilities”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.
| Parameter | Type | Description |
|---|---|---|
prompt required | string | The feel of the track in a few words — genre, energy, instrumentation. No lyrics. |
duration_seconds | number | Roughly how long it needs to play. Defaults to 30. |
job_id | string | The 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.
| Parameter | Type | Description |
|---|---|---|
prompt required | string | What the sound should be. |
duration_seconds | number | How long it should run. |
sfx_type | string | Rough category, e.g. "transition", "impact", "whoosh". |
job_id | string |
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.
| Parameter | Type | Description |
|---|---|---|
prompt required | string | What the shot should show. |
source_type | string | Moving footage or a still. Defaults to video. One of: video, image. |
aspect_ratio | string | The video's aspect ratio, so the search asks for the right orientation. One of: 9:16, 16:9, 1:1. |
Listings
Section titled “Listings”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.
| Parameter | Type | Description |
|---|---|---|
type required | string | One 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.