Extrai a trilha de áudio de um vídeo para um arquivo separado.

Args: path: Vídeo, relativo ao workspace. audio_format: mp3, wav, aac ou flac. background: Executa como job e devolve job_id.

Transcreve a fala de um áudio ou vídeo, com tempos de cada trecho.

Combine com cut_video para cortar por conteúdo falado. É lento, por isso roda em background por padrão.

Args: path: Áudio ou vídeo, relativo ao workspace. model_size: Modelo whisper: tiny, base, small, medium ou large-v3. language: Código do idioma (pt, en). Detecta automaticamente se omitido. background: Executa como job e devolve job_id.

Lista os arquivos disponíveis no workspace.

Chame primeiro para descobrir com o que trabalhar. Não altera nada.

Args: directory: Subdiretório do workspace. Raiz por padrão. kind: Filtra por tipo: video, audio, image ou other. recursive: Inclui subdiretórios.

Apaga permanentemente um arquivo do workspace.

Use para limpar saídas intermediárias. Não há lixeira nem desfazer.

Args: path: Arquivo, relativo ao workspace.

Informa se um job em background está pending, running, done ou failed.

Quando estiver done, chame job_result para obter a saída.

Args: job_id: Id devolvido pela tool que iniciou o job.

Obtém o resultado de um job que já terminou.

Retorna erro job_not_finished se ainda estiver rodando.

Args: job_id: Id devolvido pela tool que iniciou o job.

Lê duração, resolução, fps, codecs e tamanho de um vídeo.

Use antes de cortar ou concatenar para conhecer o arquivo. Não altera nada.

Args: path: Caminho do vídeo, relativo ao workspace.

Corta o trecho entre start e end (segundos) e salva um novo arquivo.

O original não é modificado. Por padrão copia os streams sem re-encodar, o que é rápido mas corta no keyframe mais próximo. Use reencode=true para corte exato no frame. Para vídeos longos use background=true e acompanhe com job_status.

Args: path: Vídeo de origem, relativo ao workspace. start: Início do trecho em segundos. end: Fim do trecho em segundos. reencode: Re-encoda para corte exato (mais lento). background: Executa como job e devolve job_id.

Junta dois ou mais vídeos na ordem informada em um único arquivo.

Os vídeos devem ter o mesmo codec e resolução (por exemplo, cortes do mesmo original). Os arquivos de entrada não são alterados.

Args: paths: Lista de vídeos, relativa ao workspace, na ordem desejada. output_name: Nome do arquivo de saída. Gerado automaticamente se omitido. background: Executa como job e devolve job_id.

Detecta mudanças de cena e devolve os intervalos de cada cena.

Use para decidir onde cortar. Percorre o vídeo inteiro, então em vídeos longos prefira background=true.

Args: path: Vídeo, relativo ao workspace. threshold: Sensibilidade entre 0 e 1. Menor detecta mais cenas. background: Executa como job e devolve job_id.

Extrai um único frame do vídeo no instante informado e salva como imagem.

Útil para conferir visualmente o conteúdo antes de cortar.

Args: path: Vídeo, relativo ao workspace. time: Instante em segundos. image_format: png ou jpg.