Zum Hauptinhalt springen

Nächstes Tool finden

Dokumentation/API/Medien-API: Video- und Audiokonvertierung
API

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.

operationNützliche Felder
convertformat: mp4, webm, mkv, mp3, wav, flac, m4a, ogg, aac, gif
compress-videocrf (18–40, höher = kleiner) oder targetMb für eine Zielgröße
compress-audiobitrate, z. B. "128k"
trim-video / trim-audiostart und duration in Sekunden
resize-video / change-video-resolutionwidth, height
change-video-speedspeed, z. B. 1.5
mute-video, video-to-gif, gif-to-mp4format; 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.

Verwandte Anleitungen