Pixerate-Videoeditor

Ein Projekt ist einfaches JSON: Bildgröße, fps, ein Hintergrund, Assets (Video-, Audio- oder Bilddateien mit einem src und, bei Video und Audio, einer duration), Spuren von oben nach unten aufgelistet (Videospuren enthalten Medien, Titel und Farbclips; Audiospuren enthalten Ton; eine frühere Videospur überdeckt eine spätere) und Marker. Ein Clip hat einen start und eine duration auf der Timeline; ein Medienclip hat zusätzlich einen in-Punkt in sein Asset, speed, volume, muted; jeder Clip kann fadeIn, fadeOut, opacity, fit und transform sowie einen transition von dem Clip, der dort endet, wo er auf derselben Spur beginnt, haben.

Ein Projekt kann auch verschachtelte Sequenzen enthalten ({ id, name, tracks }, mit eigener Timeline ab 0). Ein Compound-Clip (type: "sequence", sequence, in) spielt einen Ausschnitt einer Sequenz als ein einzelnes Bild und einen einzelnen Ton ab: Seine Deckkraft, Transformation, Überblendung, Grading, LUT, Fades, Übergänge und Animationen wirken auf die Komposition der Sequenz, und sein volume, muted und Fades wirken auf den Mix der Sequenz. Compound-Clips werden mit normaler Geschwindigkeit abgespielt (kein speed oder Ramp), und die Clips innerhalb einer Sequenz können gelesen (list_video_sequences), aber noch nicht bearbeitet werden.

Alle Zeiten sind Millisekunden auf der Timeline (oder in die Quelle für in). IDs: Spuren sehen aus wie v1 / a1, Clips wie c1, Marker m1; Sie können beim Hinzufügen eigene IDs vergeben. Lesen Sie sie aus get_video_project; erfinden Sie sie nie.

Für Fehler, namespaced Tool-Namen und Undo-Konventionen siehe pixerate-agent-tools.

Workflow-Skills

Laden Sie für diese Aufgaben auch das Workflow-Skill: Es enthält die Methode, die Prüfungen zwischen den Schritten und die Fallstricke und verwendet die untenstehenden Tools.

pixerate-talking-head-edit: Dialogbereinigung per Transkript: Füllwörter, Pausen, Stottern.
pixerate-bgm-alignment: Schneiden auf den Takt, Musik unter Sprache ducken, Lautstärke.
pixerate-video-social-cut: Vertikale Neurahmungen, zuerst der Hook, Plattformlängen, Titel im sicheren Bereich.
pixerate-video-colour-grade: Aufnahmen korrigieren und angleichen, ein Look auf einem Anpassungsclip, LUTs und Haut.
pixerate-video-montage: Auswahl auf den Takt, Tempo, Übergänge, Musik und das Ende.

Arbeitsmethode

Lesen. get_video_project für Einstellungen, Assets, Spuren, Clips (mit Ende und Quellbereich), eine Zusammenfassung jeder verschachtelten Sequenz, Marker und Probleme. Bei Compound-Clips zeigt list_video_sequences, was sie enthalten. Setzen Sie zuerst Bildgröße und fps mit set_video_settings, wenn das Projekt neu ist; eine spätere Änderung verschiebt bildbasierte Grenzen.
Medien importieren. add_video_asset für jede Datei mit kind, src und der Quell-duration (ohne diese können Trims nicht geprüft werden und check_video_project warnt unknown-duration). Geben Sie poster für Video an, damit gerenderte Frames ein Bild zeigen.
Struktur markieren. add_video_marker an Beats, Abschnitten oder Überprüfungsnotizen; Clip-Kanten rasten im UI an Markern ein und Marker machen seek_video-Ziele.
In einem Batch montieren. Verwenden Sie edit_video für einen Rohschnitt: add_asset, add_track, dann add_clip-Operationen in Reihenfolge, mit expliziten Clip-IDs, damit spätere Operationen (Trim, Transition) sie benennen können. Führen Sie es zuerst mit dry_run: true aus; der Fehler benennt die fehlschlagende Operation.
Verfeinern mit den Einzel-Tools: trim_video_clip, split_video_clip, move_video_clip, update_video_clip, set_video_transition, delete_video_clips / close_video_gaps; für das Timing zwischen Aufnahmen verwenden Sie die Trim-Modi, die ein Editor verwenden würde: roll_video_edit (einen Schnitt verschieben), slip_video_clip (ändern, was eine Aufnahme zeigt), slide_video_clip (eine Aufnahme zwischen ihren Nachbarn verschieben); für einen ganzen Abschnitt split_video_at, lift_video_range oder extract_video_range. Animieren Sie Deckkraft, Lautstärke oder Position mit set_video_keyframes.
Nach Text schneiden, wenn das Medium Sprache enthält: set_video_transcript für jedes Sprach-Asset (oder prüfen Sie transcriptWords in get_video_project), get_video_transcript zum Lesen des Schnitts, dann find_video_fillers, find_video_pauses oder find_video_transcript_text und übergeben Sie die zu entfernenden Bereiche an remove_video_ranges in einem Aufruf. Lesen Sie danach das Transkript erneut: Jedes Mal, wenn ein Schnitt verschoben wurde.
Prüfen. check_video_project und beheben Sie jeden Fehler und jede Warnung; find_video_gaps für unbeabsichtigte schwarze Stellen oder Stille.
Ansehen und anhören. get_video_frame an Schnitten und Übergängen für Ebenen und Audio-Gains als Zahlen; render_video_frame mit times für ein Kontaktblatt der Sequenz. Rendern Sie nach einem Batch, nicht nach jeder Bearbeitung.
Exportieren, wenn gewünscht: export_video_ffmpeg (ein auszuführender Befehl, kein Render) oder export_video_edl (eine Spur) zur Fertigstellung anderswo. Lesen Sie die zurückgegebenen Hinweise. Für eine Auslieferungslautstärke lassen Sie den Host zuerst export_video_loudness_measure ausführen und übergeben Sie das Ausgedruckte als loudness.measured; ein Durchgang (loudness ohne measured) ist für einen Entwurf in Ordnung.
Zuerst planen, wenn der Benutzer es sehen soll. Für alles Große oder Beurteilungsschwere (einen Rohschnitt, eine Bereinigung, Schneiden auf Musik) schlagen Sie es mit plan_video_edits (oder einem plan_*-Tool aus den Dialog- und Musik-Skills) vor, anstatt es anzuwenden: Das Projekt ändert sich nicht, der Editor zeigt den Plan mit seiner Längenänderung und den geschnittenen Abschnitten, und Sie wenden ihn mit apply_video_edit_plan an, sobald der Benutzer zustimmt (oder discard_video_edit_plan). list_video_edit_plans zeigt, was wartet und ob sich das Projekt seitdem geändert hat.
Effekte (nur, wenn der Host einen Effekte-Anbieter registriert hat; search_effects sagt sonst available: false): search_effects mit einem use, dann describe_effect für dessen Steuerelemente, dann apply_effect (Filter und Überlagerungen auf einem Clip), set_video_effect_transition oder add_video_effect_clip (Generatoren und Titel). Optimieren Sie mit update_effect und set_video_effect_keyframes; überprüfen Sie mit get_video_frame (Ebenenliste effects) und list_applied_effects. Ein Effekt entlang eines Pfads (ein Strahl entlang einer Grenze, eine Spur, geschriebene Wörter): search_effects mit accepts: ["path"], fügen Sie ihn als Clip oder Clip-Effekt hinzu, dann set_video_effect_path mit Frame-points, Pfaddaten d, einer Clip-mask-Kontur oder text.
Kamerabewegungen (ein Anbieter mit Kamerabewegungen, wie Flair): Ein Clip ist die Aufnahme. list_video_camera_moves mit einer role, dann set_clip_camera_move: transition bewegt sich von from zu framing vom Start des Clips (ein Gleiten, Peitschenschwenk, Punch-Zoom); hold läuft über den Rest des Clips bei framing (ein Ken-Burns-Drift auf einem Standbild). Die Bewegungen werden in die x-, y-, Skalierungs- und Rotations-Keyframes des Clips bei der fps des Projekts eingebacken, zwei Keyframes an einem Schnitt, sodass Vorschau und Exporte sie ohne den Anbieter abspielen. Überprüfen Sie mit get_video_frame.
Sequenz-Vorlagen (ein Anbieter mit Vorlagen): Für einen vorgefertigten Opener, eine Enthüllung oder einen Countdown, list_templates, dann describe_template für seine Slots, dann fill_template mit values (beginnen Sie mit seinen exampleValues) und at. Es landet auf neuen Spuren über den anderen als ein Undo-Schritt: Jede Aufnahme hat ihre untere Ebene auf einer Basisspur, die den Übergang der Aufnahme trägt, andere Ebenen als Effekt-, Bild- und Text-Clips nach Rolle. Offene Slots werden als graue Platzhalter-Clips (placeholders) zurückgegeben; legen Sie das echte Bild mit add_video_asset und add_video_clip im overwrite-Modus darüber. Kamerabewegungen werden nicht übernommen: Fügen Sie sie mit set_clip_camera_move hinzu.

Best Practices

Auf Aktion schneiden. Setzen Sie einen Schnitt während einer Bewegung (eine Drehung, eine Türöffnung), damit die Kontinuität der Bewegung ihn verbirgt; split_video_clip an der Aktion, dann trimmen Sie die ausgehende und eingehende Seite.
Jump Cuts vermeiden. Zwei aufeinanderfolgende Aufnahmen desselben Motivs aus fast derselben Kameraposition wirken wie ein Fehler. Ändern Sie den Winkel oder die Größe, decken Sie den Schnitt mit B-Roll auf einer höheren Videospur ab, oder machen Sie ihn bewusst.
J- und L-Cuts. Lassen Sie den Ton dem Bild vorausgehen oder folgen: Legen Sie den Ton des Mediums auf eine Audiospur (ein Clip desselben Video-Assets), stummen Sie den Videoclip (muted: true), und dann roll_video_edit den Audio-Cut früher (J) oder später (L) als den Bild-Cut. Das glättet Dialoge und Szenenwechsel.
Übergänge sparsam einsetzen. Ein gerader Schnitt ist der Standard. Verwenden Sie crossfade für Zeitabläufe oder einen sanften Szenenwechsel, dip (zu Schwarz oder einer color) für einen Abschnittswechsel, wipe selten. Halten Sie sie kurz (300-1000 ms). push und slide eignen sich eher für Grafiken, Montagen und Social-Media-Schnitte als für Dramen; iris ist ein stilisierter Retro- oder Comiceffekt. Jeder Typ außer dip benötigt Handles: die halbe Dauer ungenutzten Mediums nach dem Schnitt auf beiden Clips; dip benötigt keine.
Einfügen vs. Überschreiben. add_video_clip und move_video_clip akzeptieren mode: refuse (Standard; der Fehler benennt den nächsten freien Platz), overwrite (ersetzen, was darunter ist, wie ein Overwrite-Edit) oder insert (späteres Material weiterschieben). Verwenden Sie ripple: true bei Trim und Delete, und extract_video_range anstelle von lift_video_range, um alles nach dem Edit synchron ohne Lücke zu halten. Ripple und Insert verschieben jede entsperrte, synchronverknüpfte Spur, sodass Dialog und Bild zusammenbleiben; schalten Sie syncLocked mit update_video_track für ein Musikbett aus, das an Ort und Stelle bleiben soll.
Mit dem richtigen Tool trimmen. Um zu ändern, wann ein Schnitt passiert, ohne etwas anderes zu verschieben, roll_video_edit; um zu ändern, welchen Moment eine Aufnahme zeigt, slip_video_clip; um eine Aufnahme früher oder später zwischen zwei andere zu verschieben, slide_video_clip. Alle drei halten die Timeline lückenlos und melden das Delta, das sie tatsächlich angewendet haben (begrenzt auf verfügbares Medium).
Keyframes sparsam einsetzen. Verwenden Sie set_video_keyframes für einen Push-In (scale 1 auf 1,1 über die Aufnahme), ein Ducken unter Dialog (volume) oder ein Fade, das nicht an einer Kante ist; erleichtern Sie (ease-in-out) statt linear für Bewegung. Einfache Fades an den Clip-Kanten sind fadeIn / fadeOut.
Dialog zuerst per Text straffen. Mit einem Transkript entfernen Sie Füllwörter und Pausen mit den Find-Tools und einem remove_video_ranges; überprüfen Sie zuerst die Füllerliste (ein "weißt du" kann beabsichtigt sein). Lassen Sie 150-300 ms um Wörter (keep), damit die Sprache atmet. Ohne Transkript verwenden Sie den Ton selbst, siehe unten.
Dialog nach Gehör, in Zahlen straffen. find_video_silences auf einem Interview- oder Voiceover-Clip listet die Pausen in Timeline-Zeit auf; extrahieren Sie die langen (lassen Sie 150-300 ms auf jeder Seite, damit die Sprache nicht abgeschnitten klingt: verkleinern Sie jeden Bereich vor extract_video_range, und extrahieren Sie von der letzten Pause zurück zur ersten, oder lesen Sie erneut, da jede Extraktion das Folgende verschiebt). Verwenden Sie get_video_audio_levels, um zu finden, wo eine Zeile beginnt, bevor Sie daran trimmen oder splitten.
Geschwindigkeitsrampen für Betonung. Rampen Sie kurz vor dem Moment, der wichtig ist (ein Sprung, eine Enthüllung), in Zeitlupe und danach wieder heraus: set_video_speed_ramp mit einem 300-600 ms Gleiten (toSpeed) statt einer abrupten Änderung und Zeitlupe um 0,25-0,5. Ein Standbild (1-2 s) eignet sich für einen Titel oder einen "das bin ich"-Moment; fügen Sie es mit add_video_freeze_frame hinzu. Gerampter Ton ist gestuft und in Standbildern stumm, also legen Sie Musik oder Effekte unter gerampte Aufnahmen anstelle ihres eigenen Tons.
Lücken schließen. Unbeabsichtigte Lücken werden als Hintergrundfarbe und Stille abgespielt. find_video_gaps, dann close_video_gaps oder Ripple-Deletes. Lassen Sie Lücken nur dort, wo Sie Schwarz wünschen.
Auf Frames schneiden. Setzen Sie Starts, Trims und Splits auf Framegrenzen (Vielfache von 1000 / fps ms; 41,667 bei 24 fps, 33,333 bei 30). Bearbeitungen runden nicht für Sie.
Audio-Pegel. Dialog ist die Referenz; halten Sie Musik darunter (Lautstärke um 0,2-0,4 unter Sprache, mehr zwischen den Zeilen) und vermeiden Sie Gains über 1, die clippen. volume pro Clip und volume pro Spur multiplizieren sich. Geben Sie jedem Audioclip, der mitten im Ton beginnt oder endet, ein kurzes fadeIn / fadeOut (10-50 ms), um Klicker zu vermeiden; blenden Sie Musikbetten über 1-3 s ein/aus. Formen Sie Audio-Fades mit fadeInCurve / fadeOutCurve: equal-power, wo zwei Töne überlappen (es hält die Lautstärke konstant, wo linear in der Mitte abfällt; audioCurve von Übergängen ist bereits standardmäßig darauf für Crossfades und Wipes eingestellt), exponential, um Musik natürlich zur Stille auszublenden, s-curve für einen sanften Start und Abschluss. Linear ist der Standard.
Auslieferungslautstärke. Normalisieren Sie den endgültigen Mix, anstatt Clip-Lautstärken zu pushen: -14 LUFS für Web und Streaming, -16 für Podcasts, -23 (EBU R128) oder -24 (ATSC) für Rundfunk, mit True Peaks bei oder unter -1 dBTP. Zwei Durchgänge erhalten die Dynamik; ein Durchgang pegelt das Niveau.
Grading in zwei Durchgängen: korrigieren, dann Look. Bringen Sie zuerst jede Aufnahme ins Gleichgewicht, sodass eine Szene übereinstimmt (update_video_clip grade: Belichtung und Weißabgleich gegen die beste Aufnahme korrigieren, dann copy_video_grade von ihr auf den Rest der Szene), dann fügen Sie einen Look mit apply_video_grade_preset in einer moderaten amount (0,3-0,6) oder einem .cube-Look, den der Benutzer hat, mit set_video_lut (oft mit strength 0,5-0,8: Filmemulationen und kreative LUTs sind bei voller Stärke stark). Eine LUT läuft nach den Grading-Einstellungen, also korrigieren Sie zuerst Belichtung und Weißabgleich; LUTs, die für Log-Material gebaut wurden, erwarten ein flaches Bild und sehen auf normalem Video verzerrt aus. Überprüfen Sie mit render_video_frame zu einigen Zeiten nebeneinander. Hauttöne sind die Referenz: Vermeiden Sie starke hue oder tint bei Menschen.
Anpassungsebenen für Looks über Aufnahmen hinweg. Anstatt jeden Clip einer Szene gleich zu graden, add_video_adjustment_clip auf einer Spur darüber mit dem Look (grade, ein preset mit einer amount oder Effekte mit apply_effect auf dem Anpassungsclip): Es ändert alles darunter, während es läuft, sodass Trims und neue Clips den Look übernehmen. Der Bereich all umfasst Titel und Spuren darüber; der Bereich track beschränkt ihn auf eine Spur. Blenden Sie ihn ein und aus (fadeIn / fadeOut), um einen Look sanft einzuschleusen, und geben Sie ihm eine Maske, um ihn auf einen Teil des Bildes zu beschränken.
Masken für punktuelle Änderungen. set_video_clip_mask schneidet einen Clip auf eine Form zu (ellipse für ein Gesicht oder eine Vignette, rectangle mit corner_radius für Bild-in-Bild, linear für einen geteilten Bildschirm oder einen abgestuften Himmel, polygon für eine individuelle Form; invert: true kehrt die Maske um). Eine Maske auf einem Anpassungsclip begrenzt den Look auf einen Teil des Bildes (z. B. ein Gesicht aufhellen, ohne den Hintergrund zu beeinflussen). Verwenden Sie sie sparsam, da harte Maskenkanten weichgezeichnet werden müssen (Pixel um Pixel).
Hautton-geschützte LUTs. set_video_lut hat einen optionalen skinProtection-Parameter. Wenn True, wendet der Editor die LUT auf alles außer Hauttöne an. Das beugt unnatürlichen Farbstichen auf Gesichtern vor und gibt die Freiheit, die Umgebung stark zu verändern. LUTs, die mit skinProtection: true registriert wurden (laut describe_effect), sind darauf ausgelegt, den Hautton zu bewahren.
Color-Wheels und Kurven im Grading. update_video_clip grade akzeptiert shadows, midtones, highlights mit hue, saturation, lift, gamma, gain und offset für jede Bande. Arbeiten Sie von den Mitteltonen zu den Schatten und Lichtern: Korrigieren Sie zuerst mit lift/gamma/gain, verleihen Sie den Mitten eine Farbtönung (midtones.hue mit niedriger saturation – 0,05–0,15 für Filmlooks, mehr wird karikaturhaft). Vermeiden Sie es, Schatten oder Lichter auf null zu setzen; das schneidet ab. Verwenden Sie curves { hueVsHue, hueVsSat, lumVsSat } für Feinanpassungen.
Kamerabewegungen anwenden. set_clip_camera_move auf einem Clip erzeugt einen Punch/Zoom oder eine Gleitbewegung. Ein transition-Move spielt sich vom Start des Clips bis zur angegebenen Zeit ab (schnell: 200–600 ms für einen Peitschenschwenk); ein hold-Move hält die framing für den Rest des Clips (ein Drift). Wählen Sie framing nach Rolle: close-up für Schlagworte, mid für Gespräche, wide für Umgebungen. Bewegen Sie sich nicht von wide zu close-up am selben Clip; das ist ruckelig; schneiden Sie stattdessen zu einer neuen Aufnahme.
Sequenzen für Organisation. Gruppieren Sie verwandte Aufnahmen (z. B. eine Montage, eine Interview-Reihe) in einer Sequenz, um die Haupt-Timeline übersichtlich zu halten. Arbeiten Sie den Inhalt einer Sequenz aus, bevor Sie sie in die Haupt-Timeline legen, da Compound-Clips nicht in einzelne Clips aufgelöst werden können.
Projekt prüfen, nicht nur Clips. Lassen Sie check_video_project nach jeder Runde größerer Bearbeitungen laufen; es fängt Overlaps, Lücken, fehlende Assets, festgefahrene Übergänge und unausgeglichene Audiopegel ab. Beheben Sie zuerst Fehler, dann Warnungen.
Transkript nach dem Schnitt erneut laden. Nach jedem remove_video_ranges oder manuellen Schnitt liest set_video_transcript die neue Rohübersetzung (falls der Editor sie unterstützt); ohne dies arbeiten Find-Tools mit alten Zeiten.
Stumm-Clips für Stille. Fügen Sie für eine bestimmte stille Lücke (zwei Wörter auseinanderziehen, vor einem Schlagwort Platz lassen) einen proto: "empty"-Clip auf der Audiospur mit muted: false hinzu. volume: 0 macht dasselbe.
Export für die Fertigstellung. export_video_ffmpeg gibt einen Befehl aus, der auf dem Host ausgeführt werden muss; er rendert die Sequenz bei den Projekteinstellungen und wendet Fades, Überblendungen, Masken und Kamerabewegungen an, aber nicht die Audiopegel oder das Grading des Editors. export_video_edl ist ein CMX-3600-ELD (ein ausgewählter Modus: eine Videospur, eine Audio-/Aux-Spur), ideal für die Farbkorrektur. export_video_fcpxml (falls vorhanden) für Final Cut Pro.
Importformate. Der Editor akzeptiert, was FFmpeg lesen kann: die gängigen Video- und Audio-Container (MP4, MOV, MXF, WAV, AIFF, MP3) und Bildformate (PNG, JPEG, TIFF, EXR). Transcodieren Sie zuerst ungewöhnliche Formate auf dem Host.
Projekt-Dateigröße. Ein Projekt ist JSON; wenn es sehr groß wird (Stunden Rohmaterial), laden Sie nur den benötigten Teil mit list_video_assets und list_video_tracks vor dem Lesen, anstatt das ganze Projekt auf einmal.

Integration tests

See tests/pixerate-video-editor.test.ts and run with npm test -- --grep video.

Related skills

pixerate-talking-head-edit
pixerate-bgm-alignment
pixerate-video-social-cut
pixerate-video-colour-grade
pixerate-video-montage

Pixerate-Video-Editor

Was ist Pixerate-Video-Editor?

In Ihrer bevorzugten KI fragen

Dokumentation