Edição de Vídeo CutPilot AI
CutPilot é um fluxo de trabalho de edição local-first e Codex-first, com uma linha do tempo de revisão manual incorporada. O Codex toma decisões editoriais a partir do briefing, narração, metadados e folhas de contato do usuário; as ferramentas do CutPilot tornam essas decisões reproduzíveis e renderizáveis, enquanto o usuário pode ajustar diretamente os detalhes suportados da linha do tempo.
Fluxo de Trabalho
- Chame
inspect_media_folderna pasta fornecida pelo usuário. Não faça upload de originais. - Leia o manifesto retornado e inspecione as imagens de folha de contato geradas quando a seleção visual for importante.
- Identifique o arquivo de narração a partir da nomeação ou instrução do usuário. Pergunte apenas por escolhas criativas que não possam ser inferidas.
- Inspecione as folhas de contato, depois chame
annotate_assetscom descrições e tags visuais factuais. Não adivinhe conteúdo não visto. Construabuild_semantic_indexapós mudanças substanciais de ativos. - Prefira
search_semantic_assetspara intervalos exatos de ativos, subclipes de cena e transcrições. Passe IDs de ativos já usados emavoidAssetIdsquando o usuário desejar menos repetição. Userank_assets_for_narrationapenas como um fallback leve. - Crie um plano de corte com tomadas frequentes e semanticamente combinadas. Cada clipe visual precisa de um caminho de origem, início da linha do tempo, início da origem e duração. Nunca repita uma tomada a menos que o usuário peça ou a repetição tenha um propósito editorial claro.
- Resuma a estrutura proposta e obtenha aprovação antes de renderizações caras, a menos que o usuário tenha explicitamente solicitado a execução de ponta a ponta.
- Chame
render_projectapós a aprovação. Entregue o MP4 mais o projeto JSON.
Padrões Editoriais
- Corresponda visuais ao significado falado: código quando código é mencionado, imagens de casamento quando trabalho de casamento é mencionado, detalhes de fábrica para narração de fábrica.
- Prefira mais cortes propositais em vez de segurar um clipe genérico por muito tempo.
- Preserve a narração como áudio principal e mute o B-roll a menos que o usuário solicite som natural.
- Use 9:16, 1080x1920, 30fps para vídeo social vertical, a menos que o usuário especifique o contrário.
- Mantenha os arquivos originais intocados.
Fluxo de Trabalho Primeiro Projeto
Para uma edição durável, prefira as ferramentas de projeto v0.2:
create_projectimport_assetsinspect_media_folderedit_timelinevalidate_projectread_projecttranscribe_assetquando o tempo da transcrição for necessário. Usedownload_transcription_modeluma vez se nenhum modelo estiver disponível.set_captionseexport_subtitlesquando legendas forem solicitadas.render_projectapós o usuário aprovar o corte.- Use
edit_item_effectseset_transitionpara estilização não destrutiva de clipes. - Use
create_motion_graphic/update_motion_graphicpara títulos editáveis, terços inferiores e cartões de informação. - Use
generate_voiceoverpara TTS privado do macOS, ouregister_generated_assetpara preservar a proveniência de mídia criada por geradores externos. - Chame
create_project_snapshotantes de uma revisão autônoma substancial. Uselist_project_snapshotserestore_project_snapshotquando o usuário quiser comparar ou desfazer uma direção. - Para projetos Vlog, chame
get_vlog_workflow_statuspara encontrar o primeiro estágio incompleto baseado em evidências e sua ferramenta recomendada. - Use
submit_vlog_release_exportpara o MP4 final. Ele sempre executa uma verificação prévia rigorosa e se recusa a exportar enquanto houver bloqueadores. - Após a renderização, chame
inspect_rendered_videoe inspecione visualmente sua folha de contato. Trate avisos de segmento preto/congelado como pistas, não como falhas editoriais automáticas. - Use
export_interchangecomfcpxmlpara Resolve/Final Cut ouedlpara uma transferência simples de vídeo primário. - Use
submit_generationuma vez por imagem/vídeo/música/SFX solicitada. Usetrack_generationpara status e materialização; não coloque um resultado gerado antes que o usuário o tenha revisado quando a geração custa dinheiro. - Use
edit_item_transformpara posição, tamanho, rotação, ajuste e animação de entrada/saída/flutuação explícitos. Inspecione vários quadros para que o movimento transitório não seja confundido com layout quebrado. - Use
create_motion_graphic_from_svgpara gráficos dirigidos por propriedades criados diretamente. Declare cada{{property}}, mantenha recursos externos fora do SVG e useupdate_svg_motion_graphicpara alterações posteriores de texto/cor/origem. - Use quadros-chave de transformação ordenados para coreografia intencional de x/y/rotação. Use
cross-dissolveapenas em um limite de clipe adjacente contíguo e inspecione quadros de antes, durante e após a transição. - Quando o usuário quiser inspecionar ou ajustar manualmente a edição de IA, chame
open_review_sessioncom o projeto real e a pré-visualização mais recente, depois abra seu URL localhost no Codex. Feche-o comclose_review_sessionquando a página ao vivo não for mais necessária. - As gravações da interface de revisão são edições reais do projeto. Elas criam snapshots automaticamente e rejeitam tempo, opacidade, sobreposição, tokens expirados e intervalos de mídia malformados inválidos.
- Use
split_itemourazor_all_trackspara cortes contínuos de origem. Usetrim_itempara mudanças de limite,ripple_delete_itempara remover tempo einsert_timeline_gappara abrir tempo preservando mídia cruzada através de divisões automáticas. - Na interface de revisão, os usuários podem arradar corpos de clipe, arradar alças de corte, dividir no playhead, aplicar exclusão Ripple, inserir lacunas globais, definir transições de saída e inspecionar formas de onda geradas reais.
- As opções de transição incluem fade, dip-black, cross-dissolve, quatro wipes direcionais, revelação radial e quatro slides direcionais. Use transições avançadas apenas em limites de clipe adjacentes contíguos e verifique um quadro intermediário.
- Pontes de geração nomeadas usam
MYCUT_SEEDANCE_ENDPOINT,MYCUT_KLING_ENDPOINT,MYCUT_MUREKA_ENDPOINTouMYCUT_SFX_ENDPOINT, com variáveis_TOKENopcionais correspondentes. Elas preservam semânticas de envio/status/materialização; não afirme que um fornecedor pago foi testado ao vivo a menos que esse endpoint tenha sido realmente configurado e chamado. - Use
edit_item_keyframespara animação de x/y/scale/rotation/opacity. O easing é armazenado no keyframe esquerdo e pode ser linear, ease-in, ease-out, ease-in-out, hold ou controles Bezier Y personalizados. Verifique vários tempos renderizados. - Use
list_glsl_presetseapply_glsl_presetpara efeitos WebGL integrados, ouedit_item_effectscom tipoglslpara código-fonte de fragmento criado diretamente. Mantenha as declaraçõesu_texture,u_time,u_progresseu_resolutioncompatíveis com WebGL1 e verifique a renderização compilada. - Use
create_jsx_motion_graphicpara componentes React orientados por quadro eupdate_jsx_motion_graphicpara alterações posteriores de fonte/props. DefinaMotionGraphic; React e frame/fps/progress/dimensions são fornecidos. Verifique transparência e vários quadros. - Use
export_interchangecompremiere-xmlpara Premiere Pro,fcpxmlpara Final Cut/Resolve ouedlpara uma lista de cortes simples. Useimport_fcpxmlouimport_premiere_xmlpara criar um novo projeto CutPilot a partir de XML NLE local, depois valide e verifique a renderização da linha do tempo importada. - Use
export_jianying_draftapenas quando o usuário aceitar compatibilidade legada de texto simples experimental. Sempre informe que os rascunhos modernos do Jianying são criptografados/dependentes de versão e chamevalidate_jianying_draft; nunca afirme compatibilidade de abertura de aplicativo sem iniciar o aplicativo de destino com sucesso. - Use
list_caption_templateseupdate_caption_stylepara legendas ricas. Ativekaraokeapenas quando existirem timestamps de palavras, depois verifique vários intervalos de palavras na renderização queimada. - Use
edit_item_playbackpara velocidade constante de 0.1x-16x, curvas de velocidade editáveis, reversão ou quadros congelados de vídeo. Os pontos da curva usam o tempo da linha do tempo do clipe local mais taxa e easing; a duração da linha do tempo permanece fixa enquanto a curva integrada determina o intervalo de origem. O áudio segue a mesma curva com alongamento de tempo segmentado com preservação de pitch. - Use
edit_item_effectspara pilhas visuais não destrutivas ordenadas.chroma-keyremove uma cor RGB selecionada com controles de similaridade/mistura;masksuporta geometria retângulo/elipse, penas e inversão;color-grade,curvesevignettefornecem finalização local. Verifique transparência contra uma faixa de vídeo inferior e inspecione pixels de centro/borda/canto. - Use
edit_item_audio_effectspara processamento de áudio por clipe ordenado. A limpeza de voz normalmente começa com high-pass, gate, EQ, compressão e de-essing; stereo e pitch são ferramentas criativas. O pitch preserva a duração da linha do tempo. Meça o espectro real da renderização, dinâmica RMS/pico e energia esquerda/direita antes de relatar sucesso. - Use
render_audioquando o usuário quiser uma narração processada, mixagem de música, podcast ou transferência de áudio sem vídeo. Escolha WAV de 24 bits ou FLAC para continuação sem perdas, MP3 para entrega ampla e M4A para entrega AAC compacta; verifique se o arquivo exportado não contém fluxo de vídeo. - Use
list_timelines,create_timeline,duplicate_timeline,activate_timeline,rename_timelineedelete_timelinepara sequências separadas longas, curtas, verticais ou quadradas que compartilham uma biblioteca de ativos. Nunca delete a última linha do tempo. - Use
set_timeline_in_outerange: zoneemrender_projectourender_audiopara um intervalo de exportação exato selecionado. O fatiamento de intervalo preserva o mapeamento de origem, curvas de velocidade, legendas, marcadores e tempo de áudio sem modificar a sequência de origem. - Use
export_motion_graphicpara entregar um Motion Graphic SVG ou JSX/React como um MOV ProRes 4444 transparente autônomo. Verifique tanto o perfil 4444 quanto um formato de pixel alfayuva. - Use
read_transcript_editpara inspecionar segmentos de transcrição com tempo, depoisapply_transcript_sequencepara reordenar ou omitir segmentos de origem. Isso reconstrói vídeo/áudio de cabeça falante vinculado e legendas de palavras a partir de intervalos de origem exatos; não invente tempos de segmento aproximados. - Use
create_asset_bin,move_asset_bin,assign_assets_to_binelist_asset_librarypara organizar e pesquisar mídia local sem mover arquivos de origem. Usescan_missing_assetsantes de renderizar projetos importados ou movidos. - Use
relink_assetpara uma substituição explícita ourelink_missing_from_folderpara recuperação em massa de nome de arquivo exato. Nunca adivinhe entre correspondências ambíguas; preserve IDs de ativos para que cada referência de linha do tempo, transcrição, anotação, tag, bin e registro de geração permaneça intacto. - Os salvamentos normais de projeto entram automaticamente em um diário de editor persistente de 100 etapas. Use
editor_history_status,undo_projecteredo_projectpara reversões de edição imediatas; uma nova edição após Desfazer intencionalmente limpa o ramo Refazer. Mantenha snapshots nomeados para marcos duráveis. - Use
set_timeline_formatcom 16:9, 9:16, 1:1, 4:3 ou 3:4 para alterar a tela editável. PrefiralayoutMode: scalequando transformações, keyframes, máscaras e legendas posicionadas por pixel existentes devem se adaptar à nova tela. render_projectaceitaresolutionnão destrutiva (original,1080p,720p,480p) eframeRate(24-60). Verifique as dimensões e taxa reais do FFprobe; essas substituições de saída não devem modificar a sequência de origem editável.- Use
create_track,rename_track,reorder_track,edit_trackedelete_trackpara ciclo de vida explícito de faixas. A ordem das faixas determina a ordem de composição do vídeo; vídeo mudo fica oculto, áudio mudo fica silencioso e faixas bloqueadas rejeitam edições. - Configure
set_timeline_snappingem quadros. Usesnap_timeline_timepara visualizar uma guia oumove_item/snappedtrim_itempara alinhar com bordas de clipe, marcadores, In/Out, playhead ou início da linha do tempo. Nunca force um snap além da tolerância ou em uma sobreposição. - Use
set_edit_contextpara referências exatas no estilo ChatCut a ativos, itens da linha do tempo, tempos da linha do tempo, regiões da tela ou intervalos de origem da transcrição. Chameresolve_edit_contextantes de agir para que as decisões de IA se liguem a IDs reais e objetos cronometrados. As alterações de seleção persistem localmente, mas intencionalmente não entram em Desfazer/Refazer. - Comece um novo trabalho com
list_project_startersecreate_project_from_starterquando um cenário conhecido se encaixar. Os starters criam faixas nomeadas reais, funções de roteamento, bins, legendas, snapping, um briefing criativo salvo e um fluxo de trabalho recomendado. Useconfigure_project_starterapenas enquanto todas as linhas do tempo estiverem vazias; nunca sobrescreva uma sequência editada com um starter. - Use
place_asset_on_timelinepara montagem do monitor de origem. Defina In/Out exatos da origem e uma faixa de destino compatível.appendusa o final da faixa de destino;insertabre tempo em todas as faixas desbloqueadas e desloca legendas/marcadores;overwritemuda apenas o intervalo de destino enquanto preserva os restos esquerdo/direito contínuos da origem. - Use
place_linked_avquando o áudio original de um ativo de câmera/vídeo deve permanecer sincronizado. Membros vinculados compartilhamlinkGroupId; usemove_linked_groupetrim_linked_grouppara edições atômicas seguras para sincronia, ouunlink_timeline_itemsantes de um ajuste independente intencional. Rejeite colisões e membros bloqueados em vez de dessincronizá-los. - Prefira
submit_export_jobpara exportações longas ou visíveis ao usuário para que o Codex permaneça responsivo. Consulteread_export_joboulist_export_jobs; relate a fase exata e o caminho de saída, e usecancel_export_jobapenas quando solicitado. Os trabalhos renderizam a partir de um snapshot de projeto imutável, portanto, edições posteriores da linha do tempo não podem alterar silenciosamente uma exportação em andamento. - Use
analyze_asset_silenceantes de propor remoção de pausa. Mostre os intervalos de silêncio detectados, limite, duração mínima, preenchimento de borda de respiração e tempo total removido. Chameapply_silence_cutapenas após os intervalos serem aceitos; ele reconstrói AV vinculado contínuo da origem e remapeia legendas de transcrição. Nunca trate toda passagem silenciosa como editorialmente descartável. - Use
analyze_asset_scenesem arquivos longos de B-roll ou câmera quando os limites das tomadas forem importantes. Revise seus tempos de corte e folha de contato antes desave_scene_subclips; depois anote/tagueie subclipes ou pesquise-os comlist_asset_subclips. Useplace_asset_subclippara preservar In/Out exatos da origem detectada em vez de aproximar um intervalo de tomada. - Use
analyze_asset_beatspara inspecionar música local antes da edição de corte na batida. Revise BPM, posições das batidas, sensibilidade e intervalo mínimo antes desave_beat_markers. Construa