Ir para o conteúdo principal

Encontre sua próxima ferramenta

Documentação/API/API de mídia: conversão de vídeo e áudio
API

API de mídia: conversão de vídeo e áudio

Comprima, converta, corte, redimensione, tire o som e transforme vídeo em GIF, e converta ou comprima áudio, pelo endpoint de mídia.

Resposta curta

Faça o upload do arquivo com um upload direto e depois envie POST /api/v1/media/process/ com o objectKey como sourceKey, uma operation (convert, compress-video, compress-audio, trim-video, trim-audio, resize-video, change-video-speed, mute-video, video-to-gif, gif-to-mp4) e o formato de destino. Consulte o job retornado. Os uploads são limitados a 50 MB por arquivo.

Operações e opções

Entradas: MP4, MOV, MKV, AVI, WebM, MP3, WAV, M4A, FLAC, OGG, AAC e GIF.

operationCampos úteis
convertformat: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif
compress-videocrf (18–40; quanto maior, menor o arquivo) ou targetMb para um tamanho alvo
compress-audiobitrate, por exemplo "128k"
trim-video / trim-audiostart e duration em segundos
resize-video / change-video-resolutionwidth, height
change-video-speedspeed, por exemplo 1.5
mute-video, video-to-gif, gif-to-mp4format; duration para a duração do GIF

Comprima um vídeo

Medido em produção: um MP4 720p de 10 segundos e 2,5 MB voltou como um arquivo H.264/AAC de 1,6 MB em cerca de 19 segundos. Vídeos longos ou com bitrate alto levam proporcionalmente mais tempo.

curl -X POST 'https://maxscanner.app/api/v1/media/process/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "operation": "compress-video", "sourceKey": "users/<id>/media/inbox/…-clip.mp4", "filename": "clip.mp4", "format": "mp4" }'

Dicas práticas

  • Consulte jobs de mídia com menos frequência (a cada 10 segundos) e reserve vários minutos para vídeos longos
  • Prefira a saída MP4: ela toca em qualquer lugar e, nesta API, costuma ser menor que WebM, que é codificado priorizando a velocidade
  • Corte antes de comprimir para economizar tempo
  • Consulte GET /api/v1/media/health/ antes de um lote grande: ele informa se o processador de mídia está disponível

Perguntas frequentes

Qual é o maior vídeo que posso processar?

Hoje, 50 MB por upload. O próprio processador de mídia aceita até 500 MB, então fale com o suporte se precisar de arquivos maiores.

O áudio é mantido quando comprimo um vídeo?

Sim, em AAC, a menos que você use mute-video.

Guias relacionados