Saltar al contenido principal

Encuentra tu próxima herramienta

Documentación/API/API multimedia: conversión de vídeo y audio
API

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.

operationCampos útiles
convertformat: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif
compress-videocrf (18–40; cuanto más alto, más pequeño) o targetMb para un tamaño objetivo
compress-audiobitrate, p. ej. "128k"
trim-video / trim-audiostart y duration en segundos
resize-video / change-video-resolutionwidth, height
change-video-speedspeed, p. ej. 1.5
mute-video, video-to-gif, gif-to-mp4format; 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.

Guías relacionadas