Motion Text

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mood': {'enum': ['cinematic', 'energetic', 'intimate', 'dark', 'dreamy', 'editorial'], 'type': 'string'}, 'pace': {'enum': ['slow', 'balanced', 'fast'], 'type': 'string'}, 'title': {'type': 'string', 'maxLength': 120}, 'format': {'enum': ['16:9', '9:16', '4:5', '1:1'], 'type': 'string', 'default': '16:9'}, 'scenes': {'type': 'array', 'items': {'type': 'object', 'required': ['start', 'end'], 'properties': {'end': {'type': 'number', 'exclusiveMinimum': 0}, 'name': {'type': 'string', 'maxLength': 60}, 'start': {'type': 'number', 'minimum': 0}, 'background': {'type': 'string', 'maxLength': 300, 'description': 'CSS color or gradient only — images are added by the human in the editor.'}}}, 'maxItems': 60}, 'script': {'type': 'string', 'maxLength': 8000, 'description': 'One story beat per line; the Director paces scenes and captions to match mood and pace. Provide script OR entries.'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['words', 'start', 'end'], 'properties': {'end': {'type': 'number', 'exclusiveMinimum': 0}, 'start': {'type': 'number', 'minimum': 0}, 'words': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'effect': {'enum': ['fade', 'rise', 'pop', 'slide', 'blur', 'typewriter', 'word-reveal', 'karaoke', 'cascade', 'scatter', 'beat', 'breathe', 'float', 'slam', 'glitch'], 'type': 'string', 'description': 'How the line animates in. fade: The whole line fades from transparent to opaque without moving; on a word-timed line each word fades in separately over 0.3s at its own start. rise: The line fades in while travelling 18px (at 1080p, or an exact `distance`) from the `direction` side — up by default, so it starts below and settles upward. pop: The line scales up from 70% to full size while fading in, overshooting slightly past 100% before settling; set `fromScale` above 1 to settle down into place instead. slide: The line fades in while travelling 64px (at 1080p, or an exact `distance`) from the `direction` side — left by default, so it enters from the right. blur: The line resolves from a 14px defocus to sharp while fading in, then holds perfectly sharp and still; entrance only, never per-word. typewriter: Types the line one CHARACTER at a time at a constant rate, left to right, over `revealDuration` (default: the caption minus its hold). word-reveal: Reveals the line one whole WORD at a time with no motion — chunkier and more legible than typing; use `typewriter` for character-by-character. karaoke: The full line is visible from the first frame and the accent colour sweeps continuously through it, left to right, following measured word timings when the line has them. cascade: Words rise 18px and fade in one after another, 0.3s each and `stagger` (default 0.06s) apart, then hold still — a one-time ripple entrance, not a repeating wave. scatter: Breaks the line into separate words placed around the anchor at seeded offsets, tilts and sizes, each stamping in over 0.34s from 35% size; a lyric-card collage, best on 2–5 word lines. beat: The line snaps 5.5% larger on each detected music beat (9% on downbeats) and springs back within about a quarter second; with no beat grid it ticks steadily every 0.75s. breathe: The line oscillates smoothly and continuously between 97.5% and 102.5% scale, twice a second by default (`breathePeriod`), for as long as it is on screen. float: Each word drifts continuously in a slow figure-eight of about 4px vertically and 2px horizontally on a 2.2s loop, out of phase with its neighbours. slam: The line arrives at 190% size and accelerates down to full size in under 0.25s; set `fromScale` below 1 to punch UP from small instead, and `wobble` above 0 to add a decaying rattle. glitch: After the normal fade-in the line tears in 80ms bursts about a third of the time — red/cyan copies offset up to 6px plus a small jitter — for as long as it is on screen.'}}}, 'maxItems': 300, 'description': 'Explicitly timed text, when you already know the timings.'}, 'duration': {'type': 'number', 'maximum': 600, 'minimum': 3}, 'presetId': {'enum': ['cinematic-noir', 'neon-pulse', 'paper-journal', 'dream-haze', 'horror-signal', 'clean-editorial', 'stage-spot', 'tape-deck', 'ice-cut', 'clean-slate'], 'type': 'string', 'description': 'Visual preset; see list_visual_presets.'}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'properties': {}}