Introduction
What Heavenly is
Heavenly is LensLab’s video workspace, with a timeline and a Gemini assistant beside it. Describe an edit, review the proposed operations, then apply or undo them. Clip discovery and rendered MP4 downloads require a connected private media service.
The path that ships today:
- Choose your footage. Clip discovery uploads it for processing.
- Tell the assistant what to change and inspect its proposal.
- Apply the complete edit. Undo and redo walk revisions.
- Download a supported MP4 cut, or export an EDL, Final Cut XML, or shot sheet.
Four pieces
| Piece | What it is |
|---|---|
| Application | The studio at /heavenly/dashboard/edit. Timeline, captions, looks, export. |
| Agent | Gemini proposes validated edit operations. You preview and apply them. |
| API | The Clipping API turns a video link or file into short clips. The Motion API makes a motion design from a prompt. |
| MCP | https://lenslab.dev/api/heavenly-mcp lists Heavenly tools with no key. Project and publish calls need an hv_pat_ token. Footage stays on the machine. |
Timeline look settings: Clean, Handheld, Fast, Loud, Talk. Caption presets: Pop, Karaoke, Boxed, Bounce, Minimal, Outline. A setting in the editor is not a promise of rendered support: export checks the sequence and explains unsupported operations.
Footage
Local timeline editing preserves the original file. Clip discovery uploads the source to the private media service for transcription, candidate selection, previews, and export. Gemini chat sends your prompt and relevant editing context to the server. Jobs and media are scoped to your signed-in account; server credentials are never sent to the browser.