layZ AI

Apply the ADD_TEXT editor operation to this run's timeline. Params match the ADD_TEXT entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_add_text

Move to the next module. By default marks the current step complete first.

layz_advance_step

Transcribe source audio and return metadata for this run. This server analysis does not watch frames, track subjects, infer scenes or measure engagement. Inspect actual footage with layz_view_video_frames and available video/audio tools; never use a transcript as evidence of unseen visual events.

layz_analyze_videos

Apply the APPLY_ANIMATION_TO_TRACK editor operation to this run's timeline. Params match the APPLY_ANIMATION_TO_TRACK entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_apply_animation_to_track

Add a camera move to a video or image clip as editable position/scale keyframes (renders in preview and export). params {trackId, elementId, move: push-in|pull-out|slow-zoom|snap-zoom|pan-left|pan-right|pan-up|pan-down|ken-burns|shake|zoom-in-out (in, then back by the end)|instant-zoom (cut-in that holds), intensity?:0..1=0.5, startOffset?:clip seconds=0, moveDuration?:seconds (default rest of clip), focusX?/focusY?:-0.5..0.5 of the layer to zoom toward a subject}. Replaces earlier position/scale keyframes on that clip; opacity/rotation keys stay. Pans zoom in just enough to keep the frame covered.

layz_editor_apply_camera_move

Apply a saved design style to text layers. params {style: name or styleId, elements:[{trackId, elementId}] or allCaptions:true}. Content, timing and position are unchanged.

layz_editor_apply_design_style

Arrange video/image clips into a layout: split-horizontal, split-vertical (2), pip-top-right|pip-top-left|pip-bottom-right|pip-bottom-left (2: background then inset; inset must be on a higher track), three-up (3, stacked on vertical canvases), grid-2x2 (4) or full (1, reset). params {layout, elements:[{trackId, elementId}] in cell order (left to right, top to bottom), gap?:0..200 px}. Each clip covers its cell and is cropped with an editable rectangle mask; clips should overlap in time to appear together.

layz_editor_apply_layout

Apply the APPLY_TEXT_PRESET editor operation to this run's timeline. Params match the APPLY_TEXT_PRESET entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_apply_text_preset

Give the whole video one visual direction in one step: restyle every title and caption with a theme's font, colours, outline/shadow and card. params {theme (id or name from themes in editor context: clean-studio, noir-gold, bold-pop, neon-runner, paper-cut, boardroom, kawaii-bubble, y2k-chrome, varsity-bold, zen-white, pixel-arcade, journal-ink), scope?:all|titles|captions=all}. Caption font sizes are refitted to the canvas. Undo reverses it.

layz_editor_apply_theme

Apply the APPLY_FILTER editor operation to this run's timeline. Params match the APPLY_FILTER entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_apply_filter

Apply a quick baseline to a fresh timeline, not the current stored template's full instructions. Fill the canvas while preserving existing orientation and source audio, set narration to 100%, and generate fallback commentary captions. No sound effect is added or retimed by this shortcut; existing SFX are preserved unless reset is requested. Optional flip, muteSourceAudio, narrationVolume and effectName request those specific changes. The deprecated peakMomentTime parameter remains accepted as a returned timing hint only, and never inserts an unmeasured cymbal. Search and inspect an actual sound, then place its observed climax with layz_editor_add_sound_effect or a batch via layz_apply_editor_commands. For reference matching, first call layz_get_current_step and follow its actual guided template instructions with the matching layz_editor_* tools. Review framing, typography, timing and mix; this shortcut does not claim a finished or reference-matched edit. reset explicitly discards earlier edits.

layz_apply_default_edit

When the user has a local file you cannot pass directly (no public URL, and no chat attachment you can hand to layz_import_user_file). purpose picks what it is: source-video (default), voiceover (their own narration instead of generated voice), audio (music or other sound for the editor) or image. Returns (1) uploadUrl — a one-click upload page that accepts that file type and (2) workflowUrl — the full run page. Give BOTH links to the user. Pass runId to upload into an existing run (required for voiceover, audio and image); otherwise a new source-video run is created. Poll layz_list_run_files until the file appears. For voiceover, audio and image, then call layz_import_user_file with that fileId and purpose to put it to use.

layz_request_upload

Auto colour-correct one video or image clip: measures it like INSPECT_COLOR, then adds a 'Auto grade' custom adjustment layer over the clip's time range that neutralises colour casts and balances exposure, contrast and saturation. params {trackId, elementId, strength?:0..1=0.8, samples?:1..12=6}. The layer grades everything visible in that range and stays editable (UPDATE_EFFECT_PARAMS / REMOVE_EFFECT).

layz_editor_auto_grade

Keep captions off the subject: for each caption, compare how much of the picture's subject (faces, detail, motion) sits under its usual position versus the mirrored top/bottom zone, and move it only when the other zone is clearly emptier. params {reset?:true} returns every caption to its usual position. Analyses at most 240 frames.

layz_editor_auto_place_captions

Fit a video clip to the canvas shape (e.g. 16:9 footage in a 9:16 project) and follow its subject: frames are sampled about every 0.5s, scored for faces/skin tones, detail and motion, and turned into smooth position keyframes that jump on shot changes. params {trackId, elementId, smoothing?:0..1=0.5 (higher = steadier camera)}. Change the canvas size first; replaces the clip's position/scale keyframes.

layz_editor_auto_reframe

Batch one or more already-exposed layZ editor operations in a single save/sync. Each operation type is also a dedicated tool named layz_editor_<command> (for example layz_editor_add_media_to_timeline). Prefer those individual tools for a single edit. Use this only to apply a known batch. Each item is { type, params } where type is a fixed editor command enum. Params, limits and examples are in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. responseMode full (default) returns the detailed timeline; compact returns every result, changed IDs and sync state. includeChangedElements adds complete detail for changed elements only.

layz_apply_editor_commands

Beat times from a known tempo, without analysis. params {mediaId (source seconds) or trackId+elementId of a placed clip (timeline seconds), bpm? (default the stored SET_MEDIA_INFO tempo), offset?, subdivision?:1|2|4, action?:report|markers, markEvery?=4}. Use DETECT_BEATS when the tempo is unknown.

layz_editor_beat_grid

Check that text, captions and overlays stay clear of platform UI. Vertical canvases keep 6% left, 16% right (buttons), 12% top and 25% bottom (caption and handle) clear; landscape and square keep 5% title-safe margins. params {fix?:true (move each offending item just inside), kinds?:[caption,text,overlay]}. Full-frame footage is ignored. Text size is estimated from font metrics.

layz_editor_check_safe_zones

Progress, ETA and result of a layz_render_scene job. Waits up to waitSeconds (default 55) while it is still rendering. Without jobId, returns this run's render history.

layz_get_scene_render

Check a workflow run's status and files. Optionally waits up to waitSeconds (default 55). Returns done, eta when still running, and view/download/workflow links. Use layz_show_run to display the player panel.

layz_get_run

Status of this run's edit session: drafting (with the draft's timeline context), pending-review, applied, rejected or discarded. When the user applied a manual proposal, this reloads the live project so later edits build on it.

layz_get_edit_session

Remove every timeline marker in the project. Clips and render output are unchanged.

layz_editor_clear_markers

Preview/UI control CLEAR_SELECTION for the layZ editor. Has no render effect on export. Read layz_get_capabilities for params. For timeline changes use the matching edit tools.

layz_editor_clear_selection

Remove every clip, caption, effect and transition from unlocked tracks in one step, to rebuild an edit from scratch. params {}. The main track stays (empty), locked tracks are kept, and the media library, markers and project settings are unchanged. Reversible with UNDO_LAST_CHANGE.

layz_editor_clear_timeline

Clear the mask on a timeline clip. This removes the current mask shape and is hard to reverse without recreating it. Requires runId plus trackId/elementId in params. Read layz_get_editor_context for IDs.

layz_editor_clear_element_mask

Apply the CLOSE_GAPS editor operation to this run's timeline. Params match the CLOSE_GAPS entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_close_gaps

Mark the whole workflow run as completed.

layz_complete_run

Add another timeline to this project (a teaser, an alternate cut, a different aspect). params {name, from?: empty|current=empty, switch?:boolean=true}. Timelines share the media library; each keeps its own tracks and markers.

layz_editor_create_sequence

Create a new empty web editor project (name, canvas width/height in pixels, fps). Returns projectId; then call layz_open_editor_project to edit it here. Common sizes: 1080x1920 vertical, 1920x1080 landscape, 1080x1080 square.

layz_create_project

Text-based editing: cut spoken words out of the edit by their transcript. params {query (phrase to remove), occurrence?: 1-based number or 'all'='all', padding?:0..0.3=0.05 seconds, trackIds?}. Finds the phrase in captions (FIND_IN_TRANSCRIPT first to review), then removes that time from every track: clips, linked audio, captions and effects are split and later material moves earlier. Caption text keeps only the remaining words. Needs captions (GENERATE_CAPTIONS). One undo step.

layz_editor_cut_transcript

Delete a saved version. params {versionId}.

layz_editor_delete_version

Permanently delete a saved editor project with its timeline, project media and temporary exports, exactly like deleting it in the web editor. Cannot be undone. Only call after the user explicitly confirms this projectId; pass confirm:true.

layz_delete_project

Reduce steady background noise (hiss, hum, room tone, fans) in a voice. params {trackId, elementId (audio clip, or a video clip whose audio is separated first), strength?:0.05..1=0.6 dry/wet, off?:true}. Learns the noise from the quietest passages, attenuates it, and bakes a cleaned WAV that replaces the clip's audio (cached per strength), so preview and export match. Lower strength if the voice sounds thin. Not for music or sudden noises.

layz_editor_denoise_audio

Find the tempo and beat times of a music clip. params {trackId, elementId, action?:report|markers=report, markEvery?:1..16=4}. Returns BPM and beat times in timeline seconds (first 200 listed); markers adds pink 'Beat N' markers on every markEvery-th beat. Read-only for report.

layz_editor_detect_beats

Find shot/scene changes inside one video clip by analysing its picture. params {trackId, elementId, threshold?:0.05..0.9=0.3 (lower finds softer cuts), minScene?:0.1..30=0.5 timeline seconds, action?:report|markers|split=report}. report lists timeline cut times; markers adds yellow 'Scene N' markers; split cuts the clip (and linked audio) at every scene change in one undoable step and returns the piece IDs in order. Reversed clips are rejected.

layz_editor_detect_scenes

Throw away the draft (and withdraw a pending proposal from the web editor). The live project is unchanged. Use when the user declines or the draft went wrong; start a new session to try again.

layz_discard_edit_session

Download public media URLs into a layZ workflow. Pass urls, or sourceFileIds for files already in layZ, or runId to continue an upload handoff. Returns view, download, and workflow links.

layz_download_media

Download one or more source videos into the run (video-downloader step). Successful files include owned viewUrl/downloadUrl links for the connected agent to inspect or download locally; refresh links with layz_list_run_files.

layz_download_videos

Apply the DUCK_AUDIO editor operation to this run's timeline. Params match the DUCK_AUDIO entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_duck_audio

Apply the DUPLICATE_ELEMENT editor operation to this run's timeline. Params match the DUPLICATE_ELEMENT entry in layz_get_capabilities. Target trackId/elementId/mediaId from layz_get_editor_context. For several known edits in one save, use layz_apply_editor_commands with the same type values.

layz_editor_duplicate_element