Video editing
Higgsedit runs natively in Node. A project contains project.json, imported
media/, and renders/. The installed higgsedit --help and types/fable.d.ts
define available commands and authoring fields.
OpenAI runtime
sandbox_exec reuses a per-user sandbox within its limited lifetime. Keep inputs
recoverable and export results before expiry; use background:true and poll its
returned status for long renders. A local path is not a durable deliverable. media_upload reserves
an output; media_confirm confirms it after a successful PUT. ChatGPT attachment
ingress uses media_upload_and_confirm, not a sandbox-local path.
These APIs require the matching native CLI; older sandbox builds may lack them.
A local development installation does not update the hosted sandbox. Bitrate needs
--bitrate in the installed CLI help; older builds can silently ignore it.
Capabilities
| Area |
Features |
| Media |
Import images/video/audio; source trims, cuts, fitting and audio mixing |
| Layout |
Persistent frames: column, row, equal-column grid, absolute; fill/hug sizing |
| Graphics |
Text, shaped fonts, rectangles, gradients, paths, Lucide icons, masks and mattes |
| Motion |
Raw keyframes, frame choreography, shared counters, token text, transitions, 2.5D camera |
| Effects |
Standard filters, shadows, motion blur, custom GLSL, image textures, animated uniforms |
| Output |
Native PNGs, contact sheets, MP4/MOV/MKV, H.264, H.265/HEVC Main10, AV1, target bitrate, editable projects |
Script API
Scripts accept JSX/TSX or supplied node builders; no React or DOM runtime.
| Call |
Result |
await project({dir, size, fps, background}) |
Create/open project |
await p.add(file) |
Import asset; return handle |
p.cut(handle, {from, dur, at, fit}) |
Place footage/audio |
p.compose(nodes, {at, dur, name, camera}) |
Place native graphics/media |
p.duration() / await p.read() |
Timeline length / document |
await p.frame(time, out) |
PNG |
await p.render(out, {draft, depth, codec, bitrate, accel, shards, concurrency}) |
Encoded movie |
from is source seconds; composition at is timeline seconds. Frame children
and animations use local seconds. cut and compose record work synchronously.
See the complete example.
Commands
higgsedit build edit.jsx
higgsedit inspect PROJECT --id CLIP_ID --at 1.2
higgsedit frame PROJECT 1.2 --out renders/frame.png
higgsedit sheet PROJECT --times 0.1,1,1.8
higgsedit render PROJECT --depth 10 --codec hevc --bitrate 8M --out renders/master.mp4
higgsedit do PROJECT VERB --help
inspect --at requires an ID or unambiguous name. It reports evaluated parameters,
not execution proof. doctor checks native dependencies; check validates supported
inputs. fonts list, fonts add and icons QUERY expose asset catalogs.
Boundaries
- Whole-script builds replace the timeline. Existing human/shared edits use fresh
inspection and bounded
do/ops; canonical connections require host credentials.
- Native HEVC Main10 import needs no compatibility transcode. Ten-bit output may
contain reported eight-bit compositor fallbacks; GLSL pixels are RGBA8.
- No HTML capture, runtime animation callbacks, native LUT, or shader adjustments.
Browser shader previews are not universally equivalent to native output.
- The OpenAI tool surface supplies no editable-project publishing service.
An editable local project is not a hosted editor URL.
References
- API: composition, geometry,
timing, motion.
- Text: captions, caption layers,
titles.
- Projects: assembly, patch/sync,
inspection, asset identity.
- Reference: composition patterns, limits.
1---2name: video-editing3description: |4 Edit footage and motion graphics with Higgsedit.5 Activate only for a requested edit or graphics deliverable:6 cuts, soundtrack changes, overlays and animated title cards.7 Do not activate when the user only asks to analyze, summarize, describe,8 critique or review a video, including scene-by-scene breakdowns.9 Timeline inspection is supporting work for a requested edit, not a standalone10 activation trigger. Exclude standalone still cards, image-to-video photo11 animation without native composition, generative restyling,12 transcription and subtitle text work. For speech-caption burning, use subtitles.13 Object replacements or targeted clip variants use ad-multiplier.14metadata:15 source: https://skillmd.com/skills/jhamidun/video-editing16---1718# Video editing1920Higgsedit runs natively in Node. A project contains `project.json`, imported21`media/`, and `renders/`. The installed `higgsedit --help` and `types/fable.d.ts`22define available commands and authoring fields.2324## OpenAI runtime2526`sandbox_exec` reuses a per-user sandbox within its limited lifetime. Keep inputs27recoverable and export results before expiry; use `background:true` and poll its28returned status for long renders. A local path is not a durable deliverable. `media_upload` reserves29an output; `media_confirm` confirms it after a successful PUT. ChatGPT attachment30ingress uses `media_upload_and_confirm`, not a sandbox-local path.3132These APIs require the matching native CLI; older sandbox builds may lack them.33A local development installation does not update the hosted sandbox. Bitrate needs34`--bitrate` in the installed CLI help; older builds can silently ignore it.3536## Capabilities3738| Area | Features |39| -------- | ---------------------------------------------------------------------------------------- |40| Media | Import images/video/audio; source trims, cuts, fitting and audio mixing |41| Layout | Persistent frames: column, row, equal-column grid, absolute; fill/hug sizing |42| Graphics | Text, shaped fonts, rectangles, gradients, paths, Lucide icons, masks and mattes |43| Motion | Raw keyframes, frame choreography, shared counters, token text, transitions, 2.5D camera |44| Effects | Standard filters, shadows, motion blur, custom GLSL, image textures, animated uniforms |45| Output | Native PNGs, contact sheets, MP4/MOV/MKV, H.264, H.265/HEVC Main10, AV1, target bitrate, editable projects |4647## Script API4849Scripts accept JSX/TSX or supplied node builders; no React or DOM runtime.5051| Call | Result |52| ------------------------------------------------------------------------ | --------------------------- |53| `await project({dir, size, fps, background})` | Create/open project |54| `await p.add(file)` | Import asset; return handle |55| `p.cut(handle, {from, dur, at, fit})` | Place footage/audio |56| `p.compose(nodes, {at, dur, name, camera})` | Place native graphics/media |57| `p.duration()` / `await p.read()` | Timeline length / document |58| `await p.frame(time, out)` | PNG |59| `await p.render(out, {draft, depth, codec, bitrate, accel, shards, concurrency})` | Encoded movie |6061`from` is source seconds; composition `at` is timeline seconds. Frame children62and animations use local seconds. `cut` and `compose` record work synchronously.6364See the [complete example](references/compose.md#complete-example).6566## Commands6768```bash69higgsedit build edit.jsx70higgsedit inspect PROJECT --id CLIP_ID --at 1.271higgsedit frame PROJECT 1.2 --out renders/frame.png72higgsedit sheet PROJECT --times 0.1,1,1.873higgsedit render PROJECT --depth 10 --codec hevc --bitrate 8M --out renders/master.mp474higgsedit do PROJECT VERB --help75```7677`inspect --at` requires an ID or unambiguous name. It reports evaluated parameters,78not execution proof. `doctor` checks native dependencies; `check` validates supported79inputs. `fonts list`, `fonts add` and `icons QUERY` expose asset catalogs.8081## Boundaries8283- Whole-script builds replace the timeline. Existing human/shared edits use fresh84 inspection and bounded `do`/`ops`; canonical connections require host credentials.85- Native HEVC Main10 import needs no compatibility transcode. Ten-bit output may86 contain reported eight-bit compositor fallbacks; GLSL pixels are RGBA8.87- No HTML capture, runtime animation callbacks, native LUT, or shader adjustments.88 Browser shader previews are not universally equivalent to native output.89- The OpenAI tool surface supplies no editable-project publishing service.90 An editable local project is not a hosted editor URL.9192## References9394- API: [composition](references/compose.md), [geometry](references/clip-geometry.md),95 [timing](references/animation-contract.md), [motion](references/motion-language.md).96- Text: [captions](references/caption-titling.md), [caption layers](references/caption-systems.md),97 [titles](references/title-animation.md).98- Projects: [assembly](references/assembly.md), [patch/sync](references/workflows.md),99 [inspection](references/editor-measured.md), [asset identity](references/provenance.md).100- Reference: [composition patterns](references/shot-blueprints.md), [limits](references/failure-modes.md).