API multimedia: conversión de vídeo y audio
Comprime, convierte, recorta, redimensiona, silencia y transforma vídeo en GIF, y convierte o comprime audio, mediante el endpoint multimedia.
Respuesta breve
Sube el archivo con una subida directa y envía POST /api/v1/media/process/ con el objectKey como sourceKey, una operation (convert, compress-video, compress-audio, trim-video, trim-audio, resize-video, change-video-speed, mute-video, video-to-gif, gif-to-mp4) y el formato de destino. Consulta el trabajo devuelto. Las subidas están limitadas a 50 MB por archivo.
Operaciones y opciones
Entradas: MP4, MOV, MKV, AVI, WebM, MP3, WAV, M4A, FLAC, OGG, AAC y GIF.
| operation | Campos útiles |
|---|---|
| convert | format: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif |
| compress-video | crf (18–40; cuanto más alto, más pequeño) o targetMb para un tamaño objetivo |
| compress-audio | bitrate, p. ej. "128k" |
| trim-video / trim-audio | start y duration en segundos |
| resize-video / change-video-resolution | width, height |
| change-video-speed | speed, p. ej. 1.5 |
| mute-video, video-to-gif, gif-to-mp4 | format; duration para la duración del GIF |
Comprime un vídeo
Medido en producción: un MP4 720p de 10 segundos y 2,5 MB volvió como un archivo H.264/AAC de 1,6 MB en unos 19 segundos. Los vídeos largos o con bitrate alto tardan proporcionalmente más.
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" }'Consejos prácticos
- Consulta los trabajos multimedia con menos frecuencia (cada 10 segundos) y cuenta con varios minutos para los vídeos largos
- Prefiere la salida MP4: se reproduce en todas partes y, desde esta API, suele ocupar menos que WebM, que se codifica priorizando la velocidad
- Recorta antes de comprimir para ahorrar tiempo
- Consulta GET /api/v1/media/health/ antes de un lote grande: indica si el procesador multimedia está disponible
Preguntas frecuentes
¿Cuál es el vídeo más grande que puedo procesar?
Hoy, 50 MB por subida. El procesador multimedia en sí acepta hasta 500 MB, así que contacta con soporte si necesitas archivos más grandes.
¿Se conserva el audio al comprimir un vídeo?
Sí, en AAC, salvo que uses mute-video.