Pixerate/pixerate-video-editor

Editor de video Pixerate

Un proyecto es JSON plano: tamaño de fotograma, fps, un fondo, activos (archivos de video, audio o imagen con un src y, para video y audio, una duración), pistas listadas de arriba a abajo (las pistas de video contienen medios, títulos y clips de color; las pistas de audio contienen sonido; una pista de video anterior dibuja sobre una posterior), y marcadores. Un clip tiene un inicio y una duración en la línea de tiempo; un clip de medios también tiene un punto in en su activo, velocidad, volumen, silenciado; cada clip puede tener fadeIn, fadeOut, opacidad, ajuste y transformación, y una transición desde el clip que termina donde comienza en la misma pista.

Un proyecto también puede contener secuencias anidadas ({ id, nombre, pistas }, con su propia línea de tiempo desde 0). Un clip compuesto (tipo: "sequence", secuencia, in) reproduce un tramo de una como una sola imagen y un solo sonido: su opacidad, transformación, mezcla, grado, LUT, fundidos, transiciones y animaciones se aplican al compuesto de la secuencia, y su volumen, silenciado y fundidos a la mezcla de la secuencia. Los clips compuestos se reproducen a velocidad normal (sin velocidad o rampa), y los clips dentro de una secuencia se pueden leer (list_video_sequences) pero no editar aún.

Todos los tiempos están en milisegundos en la línea de tiempo (o en la fuente para in). Ids: las pistas se ven como v1 / a1, los clips como c1, los marcadores m1; puedes establecer tus propios ids al añadirlos. Léelos desde get_video_project; nunca los inventes.

Para errores, nombres de herramientas con prefijo y convenciones de deshacer, consulta pixerate-agent-tools.

Habilidades de flujo de trabajo

Para estos trabajos, carga también la habilidad de flujo de trabajo: contiene el método, las comprobaciones entre pasos y los errores comunes, y utiliza las herramientas a continuación.

• pixerate-talking-head-edit: limpieza de diálogo por transcripción: muletillas, pausas, tartamudeos.
• pixerate-bgm-alignment: cortar al ritmo, atenuar la música bajo el habla, sonoridad.
• pixerate-video-social-cut: reencuadres verticales, primero el gancho, duraciones de plataforma, títulos en el área segura.
• pixerate-video-colour-grade: corregir y emparejar tomas, un look en un clip de ajuste, LUTs y piel.
• pixerate-video-montage: selecciones al ritmo, ritmo, transiciones, música y el final.

Método de trabajo

1. Leer. get_video_project para configuración, activos, pistas, clips (con final y rango de origen), un resumen de cada secuencia anidada, marcadores y problemas. Cuando hay clips compuestos, list_video_sequences muestra lo que contienen. Establece primero el tamaño de fotograma y fps con set_video_settings si el proyecto es nuevo; cambiarlos más tarde desplaza los límites basados en fotogramas.
2. Traer medios. add_video_asset para cada archivo con kind, src y la duración de la fuente (sin ella no se pueden comprobar los recortes y check_video_project advierte unknown-duration). Proporciona poster para video para que los fotogramas renderizados muestren una imagen.
3. Marcar estructura. add_video_marker en ritmos, secciones o notas de revisión; los bordes de los clips se ajustan a los marcadores en la interfaz y los marcadores hacen objetivos de seek_video.
4. Ensamblar en un lote. Usa edit_video para un corte preliminar: operaciones add_asset, add_track, luego add_clip en orden, con ids de clip explícitos para que operaciones posteriores (recorte, transición) puedan nombrarlos. Ejecútalo con dry_run: true primero; el error nombra la operación fallida.
5. Refinar con las herramientas individuales: trim_video_clip, split_video_clip, move_video_clip, update_video_clip, set_video_transition, delete_video_clips / close_video_gaps; para el tiempo entre tomas usa los modos de recorte que usaría un editor: roll_video_edit (mover un corte), slip_video_clip (cambiar lo que muestra una toma), slide_video_clip (mover una toma entre sus vecinos); para un tramo completo, split_video_at, lift_video_range o extract_video_range. Anima opacidad, volumen o posición con set_video_keyframes.
6. Cortar por texto cuando los medios tengan habla: set_video_transcript para cada activo hablado (o comprueba transcriptWords en get_video_project), get_video_transcript para leer la edición, luego find_video_fillers, find_video_pauses o find_video_transcript_text y pasa los rangos que quieres eliminar a remove_video_ranges en una sola llamada. Vuelve a leer la transcripción después: cada vez que un corte se ha movido.
7. Revisar. check_video_project y corrige cada error y advertencia; find_video_gaps para negro o silencio no deseados.
8. Mirar y escuchar. get_video_frame en cortes y transiciones para capas y ganancias de audio como números; render_video_frame con times para una hoja de contacto de la secuencia. Renderiza después de un lote, no después de cada edición.
9. Exportar cuando se pida: export_video_ffmpeg (un comando para ejecutar, no un renderizado) o export_video_edl (una pista) para terminar en otro lugar. Lee las notas devueltas. Para una sonoridad de entrega, haz que el anfitrión ejecute primero export_video_loudness_measure y pase lo que imprime como loudness.measured; un pase (loudness sin measured) es suficiente para un borrador.
10. Planificar primero cuando el usuario deba verlo. Para cualquier cosa grande o que requiera juicio (un corte preliminar, una limpieza, cortar con música), propónlo con plan_video_edits (o una herramienta plan_* de las habilidades de diálogo y música) en lugar de aplicarlo: el proyecto no cambia, el editor muestra el plan con su cambio de duración y los tramos que corta, y lo aplicas con apply_video_edit_plan una vez que el usuario esté de acuerdo (o discard_video_edit_plan). list_video_edit_plans muestra lo que está esperando y si el proyecto ha cambiado desde entonces.
11. Efectos (solo cuando el anfitrión registró un proveedor de efectos; search_effects dice available: false en caso contrario): search_effects con un use, luego describe_effect para sus controles, luego apply_effect (filtros y superposiciones en un clip), set_video_effect_transition o add_video_effect_clip (generadores y títulos). Ajusta con update_effect y set_video_effect_keyframes; comprueba con get_video_frame (la lista de capas muestra effects) y list_applied_effects. Un efecto a lo largo de una ruta (un haz a lo largo de un borde, una estela, palabras escritas): search_effects con accepts: ["path"], agrégalo como un clip o efecto de clip, luego set_video_effect_path con points de fotograma, datos de ruta d, el contorno mask de un clip o text.
12. Movimientos de cámara (un proveedor con movimientos de cámara, como Flair): un clip es la toma. list_video_camera_moves con un role, luego set_clip_camera_move: transition se mueve desde from a framing desde el inicio del clip (un deslizamiento, paneo de látigo, zoom de apretón); hold se reproduce durante el resto del clip en framing (una deriva Ken Burns en un fotograma fijo). Los movimientos se hornean en las teclas x, y, escala y rotación del clip a los fps del proyecto, dos teclas en un corte, por lo que la vista previa y las exportaciones los reproducen sin el proveedor. Comprueba con get_video_frame.
13. Plantillas de secuencia (un proveedor con plantillas): para una apertura prefabricada, revelación o cuenta atrás, list_templates, luego describe_template para sus espacios, luego fill_template con values (comienza desde sus exampleValues) y at. Aterriza en nuevas pistas sobre las demás como un solo paso de deshacer: la capa inferior de cada toma en una pista base que lleva la transición de la toma, otras capas como efectos, clips de imagen y texto por rol. Los espacios abiertos vuelven como clips de marcador de posición grises (placeholders); coloca la imagen real sobre uno con add_video_asset y add_video_clip en modo overwrite. Los movimientos de cámara no se transfieren: agrégalos con set_clip_camera_move.

Mejores prácticas

• Cortar en acción. Coloca un corte durante un movimiento (un giro, una puerta abriéndose) para que la continuidad del movimiento lo oculte; split_video_clip en la acción, luego recorta los lados saliente y entrante.
• Evitar cortes de salto. Dos tomas consecutivas del mismo sujeto desde casi el mismo encuadre se leen como un fallo. Cambia el ángulo o el tamaño, cubre el corte con material B-roll en una pista de video superior, o hazlo deliberado.
• Cortes J y L. Deja que el sonido guíe o siga a la imagen: coloca el sonido del medio en una pista de audio (un clip del mismo activo de video), silencia el clip de video (muted: true), y luego roll_video_edit el corte de audio antes (J) o después (L) que el corte de imagen. Esto suaviza el diálogo y los cambios de escena.
• Transiciones con moderación. Un corte directo es el predeterminado. Usa crossfade para el paso del tiempo o un cambio de escena suave, dip (a negro, o un color) para una pausa de sección, wipe raramente. Mantenlas cortas (300-1000 ms). push y slide se adaptan a gráficos, montajes y ediciones sociales más que al drama; iris es un efecto estilizado de época o cómic. Todos los tipos excepto dip necesitan handles: la mitad de la duración del medio no utilizado después del corte en ambos clips; dip no necesita ninguno.
• Insertar vs sobrescribir. add_video_clip y move_video_clip toman mode: refuse (predeterminado; el error nombra el siguiente lugar libre), overwrite (reemplazar lo que está debajo, como una edición de sobrescritura) o insert (empujar el material posterior hacia adelante). Usa ripple: true en recortes y eliminaciones, y extract_video_range en lugar de lift_video_range, para mantener todo después de la edición sincronizado sin espacios. Ripple e insert mueven cada pista sincronizada desbloqueada, por lo que el diálogo y su imagen permanecen juntos; desactiva syncLocked con update_video_track para una base musical que debe permanecer en su lugar.
• Recortar con la herramienta adecuada. Para cambiar cuándo ocurre un corte sin mover nada más, roll_video_edit; para cambiar qué momento muestra una toma, slip_video_clip; para mover una toma antes o después entre dos otras, slide_video_clip. Los tres mantienen la línea de tiempo sin espacios e informan el delta que realmente aplicaron (limitado al medio disponible).
• Fotogramas clave con moderación. Usa set_video_keyframes para un zoom (scale 1 a 1.1 en la toma), una atenuación bajo diálogo (volume), o un fundido que no está en un borde; ease (ease-in-out) en lugar de lineal para movimiento. Los fundidos simples en los bordes del clip son fadeIn / fadeOut.
• Apretar el diálogo por texto primero. Con una transcripción, elimina muletillas y pausas con las herramientas de búsqueda y un remove_video_ranges; revisa primero la lista de muletillas (un "ya sabes" puede ser intencional). Mantén 150-300 ms alrededor de las palabras (keep) para que el habla respire. Sin transcripción, usa el sonido mismo, a continuación.
• Apretar el diálogo de oído, en números. find_video_silences en un clip de entrevista o voz en off lista las pausas en tiempo de línea de tiempo; extrae las largas (mantén 150-300 ms a cada lado para que el habla no suene cortada: encoge cada rango antes de extract_video_range, y extrae desde la última pausa hasta la primera, o vuelve a leer, porque cada extracción mueve lo que sigue). Usa get_video_audio_levels para encontrar dónde comienza una línea antes de recortar o dividir en ella.
• Rampas de velocidad para énfasis. Acelera hacia cámara lenta justo antes del momento que importa (un salto, una revelación) y vuelve después: set_video_speed_ramp con un deslizamiento de 300-600 ms (toSpeed) en lugar de un cambio brusco, y cámara lenta alrededor de 0.25-0.5. Un fotograma congelado (1-2 s) se adapta a un título o un momento de "ese soy yo"; agrégalo con add_video_freeze_frame. El sonido con rampa es escalonado y silencioso en congelados, así que coloca música o efectos debajo de las tomas con rampa en lugar de su propio sonido.
• Cerrar espacios. Los espacios no deseados se reproducen como color de fondo y silencio. find_video_gaps, luego close_video_gaps o eliminaciones ripple. Deja espacios solo donde quieras negro.
• Cortar en fotogramas. Coloca inicios, recortes y divisiones en los límites de fotogramas (múltiplos de 1000 / fps ms; 41.667 a 24 fps, 33.333 a 30). Las ediciones no redondean por ti.
• Niveles de audio. El diálogo es la referencia; mantén la música por debajo (volumen alrededor de 0.2-0.4 bajo el habla, más entre líneas) y evita ganancias por encima de 1 que recorten. El volume por clip y el volume de pista se multiplican. Dale a cada clip de audio que comienza o termina en medio del sonido un breve fadeIn / fadeOut (10-50 ms) para evitar clics; desvanece las bases musicales durante 1-3 s. Da forma a los fundidos de sonido con fadeInCurve / fadeOutCurve: equal-power donde dos sonidos se superponen (mantiene la sonoridad constante, donde lineal baja en el medio; audioCurve de las transiciones ya predetermina a esto para crossfades y wipes), exponential para desvanecer música a silencio naturalmente, s-curve para un inicio y final suaves. Lineal es el predeterminado.
• Sonoridad de entrega. Normaliza la mezcla final en lugar de empujar volúmenes de clip: -14 LUFS para web y streaming, -16 para podcasts, -23 (EBU R128) o -24 (ATSC) para transmisión, con picos reales en o por debajo de -1 dBTP. Dos pases mantienen la dinámica; un pase maneja el nivel.
• Gradar en dos pasos: corregir, luego look. Primero equilibra cada toma para que una escena coincida (update_video_clip grade: corrige exposición y balance de blancos contra la mejor toma, luego copy_video_grade desde ella al resto de la escena), luego agrega un look con apply_video_grade_preset a un amount modesto (0.3-0.6), o un look .cube que el usuario tenga con set_video_lut (a menudo con strength 0.5-0.8: las LUTs de emulación de película y creativas son fuertes a plena potencia). Una LUT se ejecuta después de la configuración del grado, por lo que corrige exposición y balance de blancos primero; las LUTs construidas para material log esperan una imagen plana y se ven aplastadas en video normal. Comprueba con render_video_frame en algunos momentos lado a lado. Los tonos de piel son la referencia: evita hue o tint fuertes en personas.
• Clips de ajuste para looks entre tomas. En lugar de gradar cada clip de una escena de la misma manera, add_video_adjustment_clip en una pista sobre ellos con el look (grade, un preset a un amount, o efectos con apply_effect en el clip de ajuste): cambia todo lo que está debajo mientras se reproduce, por lo que los recortes y nuevas tomas adoptan el look. El ámbito all incluye títulos y pistas sobre él; el ámbito track lo limita a una pista. Desvanécelo dentro y fuera (fadeIn / fadeOut) para suavizar un look, y dale una máscara para limitarlo a parte del fotograma.
• Máscaras para cambios puntuales. set_video_clip_mask corta un clip a una forma (ellipse para una cara o una viñeta, rectangle con corner_radius para imagen en imagen, linear para una pantalla dividida o un cielo graduado, `polyg...