fofr/frames-to-video – Run with an API on Replicate

fofr / frames-to-video

Convert a set of frames to a video

Cold

Public
1.6K runs
CPU
GitHub
License

Iterate in the playground

Run with an API

Playground API Examples README Versions

Input

Run this model in Node.js with one line of code:

npx create-replicate --model=fofr/frames-to-video

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run fofr/frames-to-video using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const output = await replicate.run(
  "fofr/frames-to-video:f55350b82ee3d07b0a2dd329df57dd97dedb5a08daddbdd6580d3cd473eaff1d",
  {
    input: {
      fps: 4,
      frames_zip: "https://replicate.delivery/pbxt/IyPciuTwd9miRkQm3AVd4ZZrNta1i1M8rKs7vJtpy83uAIIi/frames.zip"
    }
  }
);

// To access the file URL:
console.log(output.url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run fofr/frames-to-video using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "fofr/frames-to-video:f55350b82ee3d07b0a2dd329df57dd97dedb5a08daddbdd6580d3cd473eaff1d",
    input={
        "fps": 4,
        "frames_zip": "https://replicate.delivery/pbxt/IyPciuTwd9miRkQm3AVd4ZZrNta1i1M8rKs7vJtpy83uAIIi/frames.zip"
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run fofr/frames-to-video using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "version": "fofr/frames-to-video:f55350b82ee3d07b0a2dd329df57dd97dedb5a08daddbdd6580d3cd473eaff1d",
    "input": {
      "fps": 4,
      "frames_zip": "https://replicate.delivery/pbxt/IyPciuTwd9miRkQm3AVd4ZZrNta1i1M8rKs7vJtpy83uAIIi/frames.zip"
    }
  }' \
  https://api.replicate.com/v1/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

{
  "completed_at": "2023-06-09T22:50:36.981647Z",
  "created_at": "2023-06-09T22:50:33.524934Z",
  "data_removed": false,
  "error": null,
  "id": "t354d4bbxibv7ramday7rqdut4",
  "input": {
    "fps": 4,
    "frames_zip": "https://replicate.delivery/pbxt/IyPciuTwd9miRkQm3AVd4ZZrNta1i1M8rKs7vJtpy83uAIIi/frames.zip"
  },
  "logs": "ffmpeg version 4.3.6-0+deb11u1 Copyright (c) 2000-2023 the FFmpeg developers\nbuilt with gcc 10 (Debian 10.2.1-6)\nconfiguration: --prefix=/usr --extra-version=0+deb11u1 --toolchain=hardened --libdir=/usr/lib/x86_64-linux-gnu --incdir=/usr/include/x86_64-linux-gnu --arch=amd64 --enable-gpl --disable-stripping --enable-avresample --disable-filter=resample --enable-gnutls --enable-ladspa --enable-libaom --enable-libass --enable-libbluray --enable-libbs2b --enable-libcaca --enable-libcdio --enable-libcodec2 --enable-libdav1d --enable-libflite --enable-libfontconfig --enable-libfreetype --enable-libfribidi --enable-libgme --enable-libgsm --enable-libjack --enable-libmp3lame --enable-libmysofa --enable-libopenjpeg --enable-libopenmpt --enable-libopus --enable-libpulse --enable-librabbitmq --enable-librsvg --enable-librubberband --enable-libshine --enable-libsnappy --enable-libsoxr --enable-libspeex --enable-libsrt --enable-libssh --enable-libtheora --enable-libtwolame --enable-libvidstab --enable-libvorbis --enable-libvpx --enable-libwavpack --enable-libwebp --enable-libx265 --enable-libxml2 --enable-libxvid --enable-libzmq --enable-libzvbi --enable-lv2 --enable-omx --enable-openal --enable-opencl --enable-opengl --enable-sdl2 --enable-pocketsphinx --enable-libmfx --enable-libdc1394 --enable-libdrm --enable-libiec61883 --enable-chromaprint --enable-frei0r --enable-libx264 --enable-shared\nlibavutil      56. 51.100 / 56. 51.100\nlibavcodec     58. 91.100 / 58. 91.100\nlibavformat    58. 45.100 / 58. 45.100\nlibavdevice    58. 10.100 / 58. 10.100\nlibavfilter     7. 85.100 /  7. 85.100\nlibavresample   4.  0.  0 /  4.  0.  0\nlibswscale      5.  7.100 /  5.  7.100\nlibswresample   3.  7.100 /  3.  7.100\nlibpostproc    55.  7.100 / 55.  7.100\nInput #0, image2, from '/tmp/frames/out%03d.png':\nDuration: 00:00:00.44, start: 0.000000, bitrate: N/A\nStream #0:0: Video: png, rgb24(pc), 1046x1046, 25 fps, 25 tbr, 25 tbn, 25 tbc\nStream mapping:\nStream #0:0 -> #0:0 (png (native) -> h264 (libx264))\nPress [q] to stop, [?] for help\n[libx264 @ 0x5637edc5a040] using cpu capabilities: MMX2 SSE2Fast SSSE3 SSE4.2 AVX FMA3 BMI2 AVX2\n[libx264 @ 0x5637edc5a040] profile High, level 3.2, 4:2:0, 8-bit\n[libx264 @ 0x5637edc5a040] 264 - core 160 r3011 cde9a93 - H.264/MPEG-4 AVC codec - Copyleft 2003-2020 - http://www.videolan.org/x264.html - options: cabac=1 ref=3 deblock=1:0:0 analyse=0x3:0x113 me=hex subme=7 psy=1 psy_rd=1.00:0.00 mixed_ref=1 me_range=16 chroma_me=1 trellis=1 8x8dct=1 cqm=0 deadzone=21,11 fast_pskip=1 chroma_qp_offset=-2 threads=12 lookahead_threads=2 sliced_threads=0 nr=0 decimate=1 interlaced=0 bluray_compat=0 constrained_intra=0 bframes=3 b_pyramid=2 b_adapt=1 b_bias=0 direct=1 weightb=1 open_gop=0 weightp=2 keyint=250 keyint_min=4 scenecut=40 intra_refresh=0 rc_lookahead=40 rc=crf mbtree=1 crf=23.0 qcomp=0.60 qpmin=0 qpmax=69 qpstep=4 ip_ratio=1.40 aq=1:1.00\nOutput #0, mp4, to '/tmp/out.mp4':\nMetadata:\nencoder         : Lavf58.45.100\nStream #0:0: Video: h264 (libx264) (avc1 / 0x31637661), yuv420p, 1046x1046, q=-1--1, 4 fps, 16384 tbn, 4 tbc\nMetadata:\nencoder         : Lavc58.91.100 libx264\nSide data:\ncpb: bitrate max/min/avg: 0/0/0 buffer size: 0 vbv_delay: N/A\nframe=   11 fps=0.0 q=-1.0 Lsize=     140kB time=00:00:02.00 bitrate= 572.3kbits/s speed=2.39x\nvideo:139kB audio:0kB subtitle:0kB other streams:0kB global headers:0kB muxing overhead: 0.685462%\n[libx264 @ 0x5637edc5a040] frame I:1     Avg QP:13.19  size: 36012\n[libx264 @ 0x5637edc5a040] frame P:3     Avg QP:19.59  size: 12898\n[libx264 @ 0x5637edc5a040] frame B:7     Avg QP:21.52  size:  9529\n[libx264 @ 0x5637edc5a040] consecutive B-frames:  9.1% 18.2%  0.0% 72.7%\n[libx264 @ 0x5637edc5a040] mb I  I16..4: 35.8% 35.1% 29.2%\n[libx264 @ 0x5637edc5a040] mb P  I16..4:  1.2%  3.9%  3.2%  P16..4:  9.2%  6.1%  3.4%  0.0%  0.0%    skip:72.9%\n[libx264 @ 0x5637edc5a040] mb B  I16..4:  0.3%  1.1%  1.3%  B16..8: 12.0%  6.5%  2.6%  direct: 1.2%  skip:75.0%  L0:43.6% L1:51.4% BI: 5.0%\n[libx264 @ 0x5637edc5a040] 8x8 transform intra:38.0% inter:44.6%\n[libx264 @ 0x5637edc5a040] coded y,uvDC,uvAC intra: 44.0% 12.5% 0.8% inter: 8.2% 2.2% 0.0%\n[libx264 @ 0x5637edc5a040] i16 v,h,dc,p: 54% 38%  5%  3%\n[libx264 @ 0x5637edc5a040] i8 v,h,dc,ddl,ddr,vr,hd,vl,hu: 33% 20% 26%  3%  3%  3%  3%  5%  3%\n[libx264 @ 0x5637edc5a040] i4 v,h,dc,ddl,ddr,vr,hd,vl,hu: 21% 37% 12%  6%  4%  6%  3%  6%  5%\n[libx264 @ 0x5637edc5a040] i8c dc,h,v,p: 87%  4%  8%  1%\n[libx264 @ 0x5637edc5a040] Weighted P-Frames: Y:0.0% UV:0.0%\n[libx264 @ 0x5637edc5a040] ref P L0: 58.8%  3.1%  7.3% 30.8%\n[libx264 @ 0x5637edc5a040] ref B L0: 68.0% 26.2%  5.8%\n[libx264 @ 0x5637edc5a040] ref B L1: 90.4%  9.6%\n[libx264 @ 0x5637edc5a040] kb/s:411.36",
  "metrics": {
    "predict_time": 1.929677,
    "total_time": 3.456713
  },
  "output": "https://replicate.delivery/pbxt/8qrgz3zYXHYXFlRaQTuDY2GVfsLc4agmC96kY5iYaHFe6VERA/out.mp4",
  "started_at": "2023-06-09T22:50:35.051970Z",
  "status": "succeeded",
  "urls": {
    "get": "https://api.replicate.com/v1/predictions/t354d4bbxibv7ramday7rqdut4",
    "cancel": "https://api.replicate.com/v1/predictions/t354d4bbxibv7ramday7rqdut4/cancel"
  },
  "version": "f55350b82ee3d07b0a2dd329df57dd97dedb5a08daddbdd6580d3cd473eaff1d"
}

Generated in

1.9 seconds

Tweak itReport

ffmpeg version 4.3.6-0+deb11u1 Copyright (c) 2000-2023 the FFmpeg developers
built with gcc 10 (Debian 10.2.1-6)
configuration: --prefix=/usr --extra-version=0+deb11u1 --toolchain=hardened --libdir=/usr/lib/x86_64-linux-gnu --incdir=/usr/include/x86_64-linux-gnu --arch=amd64 --enable-gpl --disable-stripping --enable-avresample --disable-filter=resample --enable-gnutls --enable-ladspa --enable-libaom --enable-libass --enable-libbluray --enable-libbs2b --enable-libcaca --enable-libcdio --enable-libcodec2 --enable-libdav1d --enable-libflite --enable-libfontconfig --enable-libfreetype --enable-libfribidi --enable-libgme --enable-libgsm --enable-libjack --enable-libmp3lame --enable-libmysofa --enable-libopenjpeg --enable-libopenmpt --enable-libopus --enable-libpulse --enable-librabbitmq --enable-librsvg --enable-librubberband --enable-libshine --enable-libsnappy --enable-libsoxr --enable-libspeex --enable-libsrt --enable-libssh --enable-libtheora --enable-libtwolame --enable-libvidstab --enable-libvorbis --enable-libvpx --enable-libwavpack --enable-libwebp --enable-libx265 --enable-libxml2 --enable-libxvid --enable-libzmq --enable-libzvbi --enable-lv2 --enable-omx --enable-openal --enable-opencl --enable-opengl --enable-sdl2 --enable-pocketsphinx --enable-libmfx --enable-libdc1394 --enable-libdrm --enable-libiec61883 --enable-chromaprint --enable-frei0r --enable-libx264 --enable-shared
libavutil      56. 51.100 / 56. 51.100
libavcodec     58. 91.100 / 58. 91.100
libavformat    58. 45.100 / 58. 45.100
libavdevice    58. 10.100 / 58. 10.100
libavfilter     7. 85.100 /  7. 85.100
libavresample   4.  0.  0 /  4.  0.  0
libswscale      5.  7.100 /  5.  7.100
libswresample   3.  7.100 /  3.  7.100
libpostproc    55.  7.100 / 55.  7.100
Input #0, image2, from '/tmp/frames/out%03d.png':
Duration: 00:00:00.44, start: 0.000000, bitrate: N/A
Stream #0:0: Video: png, rgb24(pc), 1046x1046, 25 fps, 25 tbr, 25 tbn, 25 tbc
Stream mapping:
Stream #0:0 -> #0:0 (png (native) -> h264 (libx264))
Press [q] to stop, [?] for help
[libx264 @ 0x5637edc5a040] using cpu capabilities: MMX2 SSE2Fast SSSE3 SSE4.2 AVX FMA3 BMI2 AVX2
[libx264 @ 0x5637edc5a040] profile High, level 3.2, 4:2:0, 8-bit
[libx264 @ 0x5637edc5a040] 264 - core 160 r3011 cde9a93 - H.264/MPEG-4 AVC codec - Copyleft 2003-2020 - http://www.videolan.org/x264.html - options: cabac=1 ref=3 deblock=1:0:0 analyse=0x3:0x113 me=hex subme=7 psy=1 psy_rd=1.00:0.00 mixed_ref=1 me_range=16 chroma_me=1 trellis=1 8x8dct=1 cqm=0 deadzone=21,11 fast_pskip=1 chroma_qp_offset=-2 threads=12 lookahead_threads=2 sliced_threads=0 nr=0 decimate=1 interlaced=0 bluray_compat=0 constrained_intra=0 bframes=3 b_pyramid=2 b_adapt=1 b_bias=0 direct=1 weightb=1 open_gop=0 weightp=2 keyint=250 keyint_min=4 scenecut=40 intra_refresh=0 rc_lookahead=40 rc=crf mbtree=1 crf=23.0 qcomp=0.60 qpmin=0 qpmax=69 qpstep=4 ip_ratio=1.40 aq=1:1.00
Output #0, mp4, to '/tmp/out.mp4':
Metadata:
encoder         : Lavf58.45.100
Stream #0:0: Video: h264 (libx264) (avc1 / 0x31637661), yuv420p, 1046x1046, q=-1--1, 4 fps, 16384 tbn, 4 tbc
Metadata:
encoder         : Lavc58.91.100 libx264
Side data:
cpb: bitrate max/min/avg: 0/0/0 buffer size: 0 vbv_delay: N/A
frame=   11 fps=0.0 q=-1.0 Lsize=     140kB time=00:00:02.00 bitrate= 572.3kbits/s speed=2.39x
video:139kB audio:0kB subtitle:0kB other streams:0kB global headers:0kB muxing overhead: 0.685462%
[libx264 @ 0x5637edc5a040] frame I:1     Avg QP:13.19  size: 36012
[libx264 @ 0x5637edc5a040] frame P:3     Avg QP:19.59  size: 12898
[libx264 @ 0x5637edc5a040] frame B:7     Avg QP:21.52  size:  9529
[libx264 @ 0x5637edc5a040] consecutive B-frames:  9.1% 18.2%  0.0% 72.7%
[libx264 @ 0x5637edc5a040] mb I  I16..4: 35.8% 35.1% 29.2%
[libx264 @ 0x5637edc5a040] mb P  I16..4:  1.2%  3.9%  3.2%  P16..4:  9.2%  6.1%  3.4%  0.0%  0.0%    skip:72.9%
[libx264 @ 0x5637edc5a040] mb B  I16..4:  0.3%  1.1%  1.3%  B16..8: 12.0%  6.5%  2.6%  direct: 1.2%  skip:75.0%  L0:43.6% L1:51.4% BI: 5.0%
[libx264 @ 0x5637edc5a040] 8x8 transform intra:38.0% inter:44.6%
[libx264 @ 0x5637edc5a040] coded y,uvDC,uvAC intra: 44.0% 12.5% 0.8% inter: 8.2% 2.2% 0.0%
[libx264 @ 0x5637edc5a040] i16 v,h,dc,p: 54% 38%  5%  3%
[libx264 @ 0x5637edc5a040] i8 v,h,dc,ddl,ddr,vr,hd,vl,hu: 33% 20% 26%  3%  3%  3%  3%  5%  3%
[libx264 @ 0x5637edc5a040] i4 v,h,dc,ddl,ddr,vr,hd,vl,hu: 21% 37% 12%  6%  4%  6%  3%  6%  5%
[libx264 @ 0x5637edc5a040] i8c dc,h,v,p: 87%  4%  8%  1%
[libx264 @ 0x5637edc5a040] Weighted P-Frames: Y:0.0% UV:0.0%
[libx264 @ 0x5637edc5a040] ref P L0: 58.8%  3.1%  7.3% 30.8%
[libx264 @ 0x5637edc5a040] ref B L0: 68.0% 26.2%  5.8%
[libx264 @ 0x5637edc5a040] ref B L1: 90.4%  9.6%
[libx264 @ 0x5637edc5a040] kb/s:411.36

Examples

View more examples

Run time and cost

This model costs approximately $0.0041 to run on Replicate, or 243 runs per $1, but this varies depending on your inputs. It is also open source and you can run it on your own computer with Docker.

This model runs on CPU hardware. Predictions typically complete within 41 seconds. The predict time for this model varies significantly based on the inputs.

Readme

A toolkit model that can be used to process individual frames into a video. This can be used as a post-processor after performing image processing on frames.