Build your own

• Clone this repository.

• Build Docker image:

  • docker build -t ffmpeg-api .

• Run image in foreground:

  • docker run -it --rm --name ffmpeg-api -p 3000:3000 ffmpeg-api

• Run image in background:

  • docker run -d --name ffmpeg-api -p 3000:3000 ffmpeg-api

Use existing

• Run image in foreground:

  • docker run -it --rm --name ffmpeg-api -p 3000:3000 kazhar/ffmpeg-api

• Run image in background:

  • docker run -d --name ffmpeg-api -p 3000:3000 kazhar/ffmpeg-api

Environment variables

• Default log level is info. Set log level using environment variable, LOG_LEVEL.

  • Set log level to debug:

  • docker run -it --rm -p 3000:3000 -e LOG_LEVEL=debug kazhar/ffmpeg-api

• Default maximum file size of uploaded files is 512MB. Use environment variable FILE_SIZE_LIMIT_BYTES to change it:

  • Set max file size to 1MB:

  • docker run -it --rm -p 3000:3000 -e FILE_SIZE_LIMIT_BYTES=1048576 kazhar/ffmpeg-api

• All uploaded and converted files are deleted when they’ve been downloaded. Use environment variable KEEP_ALL_FILES to keep all files inside the container /tmp-directory:

  • docker run -it --rm -p 3000:3000 -e KEEP_ALL_FILES=true kazhar/ffmpeg-api

• When running on Docker/Kubernetes, port binding can be different than default 3000. Use EXTERNAL_PORT to set up external port in returned URLs in extracted images JSON:

  • docker run -it --rm -p 3001:3000 -e EXTERNAL_PORT=3001 kazhar/ffmpeg-api

Convert

Convert audio/video/image files using the API.

• curl -F "file=@input.wav" 127.0.0.1:3000/convert/audio/to/mp3 > output.mp3

• curl -F "file=@input.m4a" 127.0.0.1:3000/convert/audio/to/wav > output.wav

• curl -F "file=@input.mov" 127.0.0.1:3000/convert/video/to/mp4 > output.mp4

• curl -F "file=@input.mp4" 127.0.0.1:3000/convert/videp/to/mp4 > output.mp4

• curl -F "file=@input.tiff" 127.0.0.1:3000/convert/image/to/jpg > output.jpg

• curl -F "file=@input.png" 127.0.0.1:3000/convert/image/to/jpg > output.jpg

Extract images

Extract images from video using the API.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/images

  • Returns JSON that lists image download URLs for each extracted image.

  • Default FPS is 1.

  • Images are in PNG-format.

  • See sample: extracted_images.json.

• curl 127.0.0.1:3000/video/extract/download/ba0f565c-0001.png

  • Downloads exracted image and deletes it from server.

• curl 127.0.0.1:3000/video/extract/download/ba0f565c-0001.png?delete=no

  • Downloads exracted image but does not deletes it from server.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/images?compress=zip > images.zip

  • Returns ZIP package of all extracted images.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/images?compress=gzip > images.tar.gz

  • Returns GZIP (tar.gz) package of all extracted images.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/images?fps=0.5

  • Sets FPS to extract images. FPS=0.5 is every two seconds, FPS=4 is four images per seconds, etc.

Extract audio

Extract audio track from video using the API.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/audio

  • Returns 1-channel WAV-file of video’s audio track.

• curl -F "file=@input.mov" 127.0.0.1:3000/video/extract/audio?mono=no

  • Returns WAV-file of video’s audio track, with all the channels as in input video.

Probe

Probe audio/video/image files using the API.

• curl -F "file=@input.mov" 127.0.0.1:3000/probe

  • Returns JSON metadata of media file.

  • The same JSON metadata as in ffprobe command: ffprobe -of json -show_streams -show_format input.mov.

  • See sample of MOV-video metadata: probe_metadata.json.