{"name":"video_editor","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list_workflows","save_workflow","list_projects","create_project","get_project","get_transcript","get_beats","get_frame","apply_commands","undo","cut_silence","cut_ranges","beat_cut","collage","set_captions","set_speed","edit_caption_cues","get_composed_frame","set_format","add_text","add_clip","animate_clip","get_motion","keyframe_clip","stagger_clips","retime_motion","add_hyperframes_clip","add_motion_graphic","get_hyperframes_clip_motion","edit_hyperframes_clip_motion","add_transition","apply_effect","draft_cut","draft_cut_status","list_variants","export","export_status","get_pool","generate","generate_status"],"description":"The editor operation. Pass that operation’s own fields alongside it."},"projectId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":100},"prompt":{"anyOf":[{"type":"string","minLength":1,"maxLength":2000},{"type":"string","maxLength":4000}]},"limit":{"type":"integer","minimum":1,"maximum":50},"assetIds":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"title":{"type":"string","minLength":1,"maxLength":500},"preset":{"anyOf":[{"type":"string","enum":["tiktok","reels","shorts","youtube","square","portrait"]},{"type":"string","enum":["fade_in","fade_out","slide_in_left","slide_in_right","slide_in_up","slide_in_down","slide_out_left","slide_out_right","pop","spring_in","zoom_out","punch_in","shake","ken_burns"]}]},"full":{"type":"boolean"},"clipId":{"anyOf":[{"type":"string"},{"type":"string","minLength":1},{"type":"string","minLength":1,"maxLength":200}]},"force":{"type":"boolean"},"timeSec":{"type":"number","minimum":0,"maximum":86400},"maxWidth":{"type":"integer","minimum":64,"maximum":1920},"expectedRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"commands":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"commandType":{"type":"string","minLength":1}},"required":["commandType"],"additionalProperties":{}}},"toRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"minSilenceSec":{"type":"number","minimum":0.1,"maximum":5},"paddingSec":{"type":"number","minimum":0,"maximum":1},"thresholdDb":{"type":"number","minimum":-80,"maximum":-10},"ranges":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"startSec":{"type":"number","minimum":0,"maximum":86400},"endSec":{"type":"number","minimum":0,"maximum":86400}},"required":["startSec","endSec"],"additionalProperties":false}},"ripple":{"type":"boolean"},"mode":{"type":"string","enum":["cut_on_beat","switch_shots","jump_cuts"]},"everyNBeats":{"type":"number","minimum":0.25,"maximum":16,"description":"Beats per shot: 0.5 = every half beat, 0.25 = every quarter beat, 1 = every beat. For quick splices or doka doka doka use 0.5."},"clipIds":{"anyOf":[{"maxItems":50,"type":"array","items":{"type":"string"}},{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string"}},{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},{"minItems":2,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}},{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200}}]},"audioClipId":{"type":"string"},"range":{"type":"object","properties":{"startSec":{"type":"number","minimum":0,"maximum":86400},"endSec":{"type":"number","minimum":0,"maximum":86400}},"required":["startSec","endSec"],"additionalProperties":false},"layout":{"type":"string","enum":["stack","side_by_side","grid"]},"atSec":{"anyOf":[{"type":"number","minimum":0,"maximum":86400},{"type":"number","minimum":0,"maximum":86400,"description":"Where it starts; screen_push starts on the first of its words said at or after it"}]},"durationSec":{"anyOf":[{"type":"number","minimum":0.1,"maximum":120,"description":"Omit to fit the panels to the shortest selected source and remaining timeline. Specify only when the person requests a duration."},{"type":"number","minimum":0.1,"maximum":60},{"type":"number","exclusiveMinimum":0,"maximum":86400},{"type":"number","minimum":0.1,"maximum":10},{"type":"number","exclusiveMinimum":0,"maximum":3600},{"type":"number","minimum":1,"maximum":15,"description":"How long it shows; screen_push and over_shoulder set their own"},{"type":"number","minimum":0.05,"maximum":3},{"type":"number","minimum":1,"maximum":600}]},"style":{"anyOf":[{"type":"string","enum":["classic","pop","pulse","glide","fusion","boxed"]},{"type":"object","properties":{"fontFamily":{"type":"string","maxLength":200},"color":{"type":"string","maxLength":32},"fontSizePx":{"type":"number","minimum":8,"maximum":400},"backgroundColor":{"type":"string","maxLength":32},"shadow":{"type":"boolean"}},"additionalProperties":false}]},"highlight":{"type":"string","enum":["none","word","karaoke"]},"maxWordsPerLine":{"type":"integer","minimum":1,"maximum":12},"position":{"type":"string","enum":["bottom","middle","top"]},"highlightColor":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"rate":{"type":"number","minimum":0.05,"maximum":20},"cues":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"clipId":{"type":"string","minLength":1},"text":{"type":"string","minLength":1,"maxLength":5000}},"required":["clipId","text"],"additionalProperties":false}},"fit":{"type":"string","enum":["cover","contain"]},"kind":{"anyOf":[{"type":"string","enum":["title","lower_third","kinetic","cta"]},{"type":"string","enum":["highlight","hook","testimonial","story","demo"]}]},"template":{"type":"string","enum":["hook_title","lower_third","kinetic_words","cta_end_card","listicle_number","quote","stat_callout","subtitle_bar"]},"text":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"string","minLength":1,"maxLength":120,"description":"screen_push: 1–15 words the speaker says, shown exactly as written"}]},"secondaryText":{"type":"string","minLength":1,"maxLength":300},"startSec":{"type":"number","minimum":0,"maximum":86400},"animationIn":{"type":"string","enum":["none","fade","pop","scale-in","float-in","slide-up","slide-down","slide-left","slide-right","typewriter","word-pop","bounce","blur-in","zoom-out","wipe"]},"animationOut":{"type":"string","enum":["none","fade","pop","scale-in","float-in","slide-up","slide-down","slide-left","slide-right","typewriter","word-pop","bounce","blur-in","zoom-out","wipe"]},"assetId":{"type":"string","minLength":1},"versionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"trackId":{"type":"string"},"newTrack":{"type":"boolean"},"sourceInSec":{"type":"number","minimum":0,"maximum":86400},"property":{"type":"string","enum":["transform.position","transform.scaleX","transform.scaleY","transform.rotationDeg","transform.rotateXDeg","transform.rotateYDeg","transform.opacity","audio.volume","audio.pan","effect.parameter","text.tracking","text.fontSize"]},"parameterName":{"type":"string","minLength":1,"maxLength":200},"effectInstanceId":{"type":"string","minLength":1,"maxLength":200,"description":"effect.parameter only: which of the clip effects; default the first with it"},"keys":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"t":{"type":"number","minimum":0,"maximum":86400,"description":"Timeline seconds"},"v":{"description":"The value, for every property but position","type":"number"},"x":{"description":"transform.position only: normalized x, 0.5 = centre","type":"number"},"y":{"description":"transform.position only: normalized y, 0.5 = centre","type":"number"},"ease":{"description":"How this key eases into the next; default linear","type":"string","enum":["hold","spring","linear","easeIn","easeOut","easeInOut","easeInBack","easeOutBack","easeInOutBack","gentle","quick","bouncy","slow"]},"bezier":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"number"},"description":"A custom ease as [x1, y1, x2, y2] (x1, x2 in 0..1), instead of ease"}},"required":["t"],"additionalProperties":false}},"replace":{"type":"boolean"},"eachSec":{"type":"number","minimum":0,"maximum":10},"from":{"type":"string","enum":["start","end","center"]},"shiftSec":{"type":"number","minimum":-3600,"maximum":3600},"ease":{"type":"string","enum":["hold","spring","linear","easeIn","easeOut","easeInOut","easeInBack","easeOutBack","easeInOutBack","gentle","quick","bouncy","slow"]},"bezier":{"minItems":4,"maxItems":4,"type":"array","items":{"type":"number"},"description":"A custom ease as [x1, y1, x2, y2] (x1, x2 in 0..1), instead of ease"},"revisionId":{"type":"string","minLength":1},"recipe":{"type":"string","enum":["glass_graph","particle_push","dot_matrix","word_lock","screen_push","over_shoulder"],"description":"glass_graph: a liquid glass card that refracts the footage under it while a line graph climbs to a figure (label, value, unit, points). particle_push: particles pour into a box that opens into up to 3 numbered steps (steps). dot_matrix: words in LED dots, one after another (words). word_lock: newspaper pages cut fast with one highlighted word locked in the centre (keyword, lines). screen_push: cuts to an extreme close-up of a monitor that shows the exact words, hard-cutting to each word as the speaker says it (text; it times itself from the transcript). over_shoulder: the camera pushes in, looks to a card over one shoulder, whips to a card over the other, then pulls back, 4.6 s (cards, faceX, faceWidth, eyeY, lightSpeed)."},"color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","description":"The accent as #RRGGBB: the glass_graph line, the screen_push letters, the over_shoulder outline; omit for the brand accent"},{"type":"string","maxLength":32}]},"label":{"type":"string","minLength":1,"maxLength":24,"description":"glass_graph: the metric, 1–3 words (\"Retention\")"},"value":{"type":"number","description":"glass_graph: the figure the graph climbs to"},"unit":{"type":"string","maxLength":4,"description":"glass_graph: \"%\", \"$\", \"k\", \"x\" or empty"},"points":{"minItems":2,"maxItems":12,"type":"array","items":{"type":"number"},"description":"glass_graph: the line, 2–12 values in order; omit for a steady climb"},"steps":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","minLength":1,"maxLength":18},"description":"particle_push: 1–3 step labels of one or two words"},"words":{"minItems":1,"maxItems":6,"type":"array","items":{"type":"string","minLength":1,"maxLength":12},"description":"dot_matrix: 1–6 words, shown one after another"},"keyword":{"type":"string","minLength":1,"maxLength":20,"description":"word_lock: the one word locked in the centre"},"lines":{"minItems":3,"maxItems":10,"type":"array","items":{"type":"string","minLength":1,"maxLength":160},"description":"word_lock: 3–10 sentences, each containing the keyword"},"cards":{"minItems":2,"maxItems":2,"type":"array","items":{"type":"object","properties":{"label":{"default":"","type":"string","maxLength":24},"big":{"type":"string","minLength":1,"maxLength":24},"small":{"default":"","type":"string","maxLength":32}},"required":["big"],"additionalProperties":false},"description":"over_shoulder: the start card (over the left shoulder) then the end card, each { label, big, small } — \"BEFORE\" | \"$3,200\" | \"per month\""},"lightSpeed":{"type":"boolean","description":"over_shoulder: the start card's big text flies into the end card at light speed"},"faceX":{"type":"number","minimum":0,"maximum":1,"description":"over_shoulder: the middle of the face across the frame, 0–1, read from get_frame"},"faceWidth":{"type":"number","minimum":0,"maximum":1,"description":"over_shoulder: the head's width ear to ear as a share of the frame width"},"eyeY":{"type":"number","minimum":0,"maximum":1,"description":"over_shoulder: the eyes' height in the frame, 0 = top"},"opsJson":{"type":"string","minLength":2,"maxLength":50000,"description":"A JSON array of 1 to 50 HyperFrames motion ops in composition seconds: add_animation, stagger, retime, ease, set_keyframes, upsert_keyframe, remove_keyframes, remove_animation, split_text"},"fromClipId":{"type":"string","minLength":1},"toClipId":{"type":"string","minLength":1},"all":{"type":"boolean"},"type":{"type":"string","enum":["cut","crossfade","dip_to_black","dip_to_white","wipe","slide","zoom","blur"]},"effect":{"type":"string","enum":["bw","vintage","vivid","cool","warm","noir","dream","blur","tint","vignette","film_grain","dust","light_leaks","chromatic_aberration","vhs","pixelate","corner_radius","chroma_key"]},"strength":{"type":"number","minimum":0,"maximum":1},"remove":{"type":"boolean"},"brief":{"type":"string","minLength":1,"maxLength":2000},"targetDurationSec":{"type":"number","minimum":5,"maximum":180},"variants":{"type":"integer","minimum":1,"maximum":5},"captions":{"type":"boolean"},"sourceAssetIds":{"maxItems":20,"type":"array","items":{"type":"string"},"description":"Omit to use enabled timeline videos. An explicit list is exclusive: selected timeline videos keep their pinned versions; new Library videos use their head version."},"music":{"type":"boolean"},"musicPrompt":{"type":"string","maxLength":300},"hookTitle":{"type":"boolean"},"broll":{"type":"boolean"},"brandCaptions":{"type":"boolean"},"jobId":{"type":"string"},"captionMode":{"type":"string","enum":["burn_in","none"]},"quickStart":{"type":"string","enum":["create_image","restyle_image","edit_image","storyboard_to_video","keyframes_to_video","rotate_360","music_bed","voiceover","headless_concept"]},"refs":{"maxItems":6,"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"role":{"default":"source","type":"string","enum":["subject","environment","style","source","first_frame","last_frame"]}},"required":["assetId"],"additionalProperties":false}},"place":{"type":"object","properties":{"atSec":{"type":"number","minimum":0,"maximum":86400},"trackId":{"type":"string"}},"required":["atSec"],"additionalProperties":false},"voice":{"type":"string","maxLength":300},"concept":{"type":"string","enum":["offer-direct","problem-solution","street-interview","street-price-guess","reply-to-comment","car-storytime","expectation-vs-reality","pov","unpopular-opinion","busy-day-routine","tour","lookbook"]},"duck":{"type":"boolean"}},"required":["action"],"additionalProperties":false}}
