Medien-API: Video- und Audiokonvertierung
Videos komprimieren, konvertieren, kürzen, skalieren, stummschalten und in GIFs umwandeln sowie Audio konvertieren oder komprimieren – über den Medien-Endpunkt.
Kurze Antwort
Laden Sie die Datei per Direkt-Upload hoch und senden Sie dann POST /api/v1/media/process/ mit dem objectKey als sourceKey, einer operation (convert, compress-video, compress-audio, trim-video, trim-audio, resize-video, change-video-speed, mute-video, video-to-gif, gif-to-mp4) und dem Zielformat. Fragen Sie den zurückgegebenen Job ab. Uploads sind auf 50 MB pro Datei begrenzt.
Operationen und Optionen
Eingaben: MP4, MOV, MKV, AVI, WebM, MP3, WAV, M4A, FLAC, OGG, AAC und GIF.
| operation | Nützliche Felder |
|---|---|
| convert | format: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif |
| compress-video | crf (18–40, höher = kleiner) oder targetMb für eine Zielgröße |
| compress-audio | bitrate, z. B. "128k" |
| trim-video / trim-audio | start und duration in Sekunden |
| resize-video / change-video-resolution | width, height |
| change-video-speed | speed, z. B. 1.5 |
| mute-video, video-to-gif, gif-to-mp4 | format; duration für die GIF-Länge |
Ein Video komprimieren
Gemessen in der Produktion: Ein 10 Sekunden langes 720p-MP4 mit 2,5 MB kam in etwa 19 Sekunden als H.264/AAC-Datei mit 1,6 MB zurück. Lange Videos oder Videos mit hoher Bitrate brauchen entsprechend länger.
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" }'Praktische Tipps
- Medien-Jobs seltener abfragen (alle 10 Sekunden) und für lange Videos mehrere Minuten einplanen
- Bevorzugen Sie MP4 als Ausgabe: Es läuft überall und ist bei dieser API meist kleiner als WebM, das auf Geschwindigkeit kodiert wird
- Vor dem Komprimieren kürzen, um Zeit zu sparen
- Vor einem großen Batch GET /api/v1/media/health/ prüfen: Der Endpunkt meldet, ob der Medien-Worker verfügbar ist
Häufige Fragen
Wie groß darf ein Video maximal sein?
Derzeit 50 MB pro Upload. Der Medien-Worker selbst akzeptiert bis zu 500 MB; wenden Sie sich an den Support, wenn Sie größere Dateien benötigen.
Bleibt der Ton beim Komprimieren eines Videos erhalten?
Ja, als AAC – es sei denn, Sie verwenden mute-video.