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.
| operation | Champs utiles |
|---|---|
| convert | format: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif |
| compress-video | crf (18 à 40 ; plus la valeur est élevée, plus le fichier est léger) ou targetMb pour viser une taille |
| compress-audio | bitrate, par exemple "128k" |
| trim-video / trim-audio | start et duration, en secondes |
| resize-video / change-video-resolution | width, height |
| change-video-speed | speed, par exemple 1.5 |
| mute-video, video-to-gif, gif-to-mp4 | format ; 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.