Aller au contenu principal

Trouvez votre prochain outil

Documentation/API/API Médias : conversion vidéo et audio
API

API Médias : conversion vidéo et audio

Compressez, convertissez, découpez et redimensionnez des vidéos, coupez-en le son ou transformez-les en GIF, et convertissez ou compressez de l’audio, via l’endpoint média.

Réponse courte

Envoyez le fichier par envoi direct, puis appelez POST /api/v1/media/process/ avec la valeur objectKey comme sourceKey, une operation (convert, compress-video, compress-audio, trim-video, trim-audio, resize-video, change-video-speed, mute-video, video-to-gif, gif-to-mp4) et le format cible. Interrogez la tâche renvoyée. Les envois sont limités à 50 Mo par fichier.

Opérations et options

Entrées : MP4, MOV, MKV, AVI, WebM, MP3, WAV, M4A, FLAC, OGG, AAC et GIF.

operationChamps utiles
convertformat: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif
compress-videocrf (18 à 40 ; plus la valeur est élevée, plus le fichier est léger) ou targetMb pour viser une taille
compress-audiobitrate, par exemple "128k"
trim-video / trim-audiostart et duration, en secondes
resize-video / change-video-resolutionwidth, height
change-video-speedspeed, par exemple 1.5
mute-video, video-to-gif, gif-to-mp4format ; duration pour la durée du GIF

Compresser une vidéo

Mesuré en production : un MP4 720p de 10 secondes pesant 2,5 Mo est revenu sous la forme d’un fichier H.264/AAC de 1,6 Mo en environ 19 secondes. Les vidéos longues ou à débit élevé prennent proportionnellement plus de temps.

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" }'

Conseils pratiques

  • Interrogez les tâches média moins souvent (toutes les 10 secondes) et prévoyez plusieurs minutes pour les longues vidéos
  • Préférez la sortie MP4 : elle se lit partout et, avec cette API, elle est généralement plus légère que WebM, encodé en privilégiant la vitesse
  • Découpez avant de compresser pour gagner du temps
  • Consultez GET /api/v1/media/health/ avant un gros lot : il indique si le worker média est disponible

Questions fréquentes

Quelle taille de vidéo puis-je traiter au maximum ?

50 Mo par envoi actuellement. Le worker média lui-même accepte jusqu’à 500 Mo : contactez le support si vous avez besoin de fichiers plus volumineux.

Le son est-il conservé quand je compresse une vidéo ?

Oui, en AAC, sauf si vous utilisez mute-video.

Guides associés