Como recortar um vídeo por início e duração

Prepare o vídeo e defina o recorte

Este utilitário serve para retirar um segmento de um vídeo a partir de dois valores: o momento de início e a duração pretendida. O resultado de uma operação bem-sucedida é um ficheiro MP4 devolvido como texto Base64. Para fornecer o vídeo, prepare dados multimédia não vazios representados em Base64. A entrada multimédia fornecida diretamente é rejeitada quando ultrapassa 50 MB.

Como recortar o vídeo

Converta o vídeo para texto Base64 e confirme que os dados não estão vazios. Se a entrada for fornecida diretamente, mantenha-a abaixo de 50 MB.
Indique o momento em que o segmento deve começar. O valor é convertido para número e fica limitado ao intervalo entre 0 e 86 400 segundos. Se não indicar um início, é usado 0 segundos.
Indique a duração do segmento. Este valor também é convertido para número e fica limitado entre 0,1 e 300 segundos. Se não indicar uma duração, são usados 10 segundos.
Submeta o vídeo juntamente com o início e a duração. O processamento depende de um ambiente FFmpeg disponível. A operação pode falhar se o vídeo não puder ser processado, se o processamento exceder o tempo permitido ou se não for produzido um ficheiro de saída não vazio.
Quando a operação terminar com sucesso, recolha o resultado em Base64 e descodifique-o como um ficheiro MP4. Guarde o vídeo recortado com uma extensão adequada ao formato de saída.

Como interpretar o resultado

Verifique primeiro se a resposta contém dados Base64 não vazios e trate esses dados como um vídeo MP4. O segmento corresponde ao ponto de início aceite e à duração aceite pelo utilitário, não necessariamente aos valores introduzidos quando estes ficam fora dos intervalos suportados. Por exemplo, um início inferior a 0 segundos é ajustado para 0, enquanto um início superior a 86 400 segundos é limitado a esse máximo; uma duração inferior a 0,1 segundos ou superior a 300 segundos é igualmente restringida.

Se não houver resultado utilizável, reveja o conteúdo Base64, o formato do vídeo e a disponibilidade do processamento necessário. Uma resposta sem ficheiro não confirma que o recorte foi concluído.

Exemplo prático

Uma pessoa precisa de separar um excerto de uma gravação de reunião para o guardar como um novo ficheiro de vídeo.

Forneça em Base64 não vazio uma gravação de uma reunião, indique o início de 45 segundos e uma duração de 20 segundos, e depois descodifique o resultado como MP4.

Uma operação bem-sucedida devolve texto Base64 não vazio que corresponde a um ficheiro MP4.

Limitações

A entrada multimédia fornecida diretamente acima de 50 MB é rejeitada. O processamento pode falhar por problemas de compatibilidade, tempo excedido ou ausência de um ficheiro de saída não vazio; além disso, início e duração ficam sujeitos aos limites suportados.

Erros comuns

Um erro frequente é enviar uma representação Base64 vazia ou uma entrada multimédia direta acima de 50 MB. Corrija-o garantindo que os dados representam um vídeo não vazio e reduzindo o tamanho da entrada direta abaixo desse limite.

Perguntas frequentes

Posso fornecer o vídeo diretamente?

Sim, desde que os dados multimédia em Base64 não estejam vazios, a entrada direta não ultrapasse 50 MB e o vídeo possa ser processado. O resultado bem-sucedido é um MP4 não vazio em Base64.

Que valores são usados quando não indico início ou duração?

Se não indicar o início, é usado 0 segundos. Se não indicar a duração, são usados 10 segundos. Os valores fornecidos são convertidos para número e limitados aos intervalos suportados.

Porque pode falhar o recorte?

Pode falhar quando o vídeo não é processável, quando o processamento excede o tempo permitido ou quando não é produzido um ficheiro de saída não vazio. Confirme também que a entrada Base64 não está vazia.