onemadgeek/frames-to-video-merger | Run with an API on Replicate

Convert a set of image frames (JPG or PNG) into a high-quality MP4 video. Automatically handles sorting and frame order for smooth playback.

Cold

Public

29 runs

CPU

Playground API Examples README Versions

Input

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

npx create-replicate --model=onemadgeek/frames-to-video-merger

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";
import fs from "node:fs";

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

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

const output = await replicate.run(
  "onemadgeek/frames-to-video-merger:e8b06d0812ad39585a1ffa078af0f29e95d7e337aa7db39bd03f63ff771f8443",
  {
    input: {
      fps: 10,
      frames_zip: "https://replicate.delivery/pbxt/N5xNFYIBwPLj6hL4deit0SKh1MWKdPXHTP7ZpPk3xKpVRyrh/replicate-prediction-djce3905znrma0cq3pytmc4kbr.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 onemadgeek/frames-to-video-merger using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "onemadgeek/frames-to-video-merger:e8b06d0812ad39585a1ffa078af0f29e95d7e337aa7db39bd03f63ff771f8443",
    input={
        "fps": 10,
        "frames_zip": "https://replicate.delivery/pbxt/N5xNFYIBwPLj6hL4deit0SKh1MWKdPXHTP7ZpPk3xKpVRyrh/replicate-prediction-djce3905znrma0cq3pytmc4kbr.zip"
    }
)

# To access the file URL:
print(output.url())
#=> "http://example.com"

# To write the file to disk:
with open("my-image.png", "wb") as file:
    file.write(output.read())

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 onemadgeek/frames-to-video-merger 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": "onemadgeek/frames-to-video-merger:e8b06d0812ad39585a1ffa078af0f29e95d7e337aa7db39bd03f63ff771f8443",
    "input": {
      "fps": 10,
      "frames_zip": "https://replicate.delivery/pbxt/N5xNFYIBwPLj6hL4deit0SKh1MWKdPXHTP7ZpPk3xKpVRyrh/replicate-prediction-djce3905znrma0cq3pytmc4kbr.zip"
    }
  }' \
  https://api.replicate.com/v1/predictions

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

Output

{
  "completed_at": "2025-05-29T21:12:53.133494Z",
  "created_at": "2025-05-29T21:12:41.559000Z",
  "data_removed": false,
  "error": null,
  "id": "n6k1qz6vaxrme0cq3qhsmk3tjc",
  "input": {
    "fps": 10,
    "frames_zip": "https://replicate.delivery/pbxt/N5xNFYIBwPLj6hL4deit0SKh1MWKdPXHTP7ZpPk3xKpVRyrh/replicate-prediction-djce3905znrma0cq3pytmc4kbr.zip"
  },
  "logs": "Output pattern detected\nSorted frame files: ['replicate-prediction-djce3905znrma0cq3pytmc4kbr-0.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-1.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-2.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-3.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-4.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-5.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-6.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-7.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-8.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-9.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-10.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-11.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-12.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-13.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-14.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-15.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-16.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-17.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-18.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-19.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-20.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-21.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-22.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-23.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-24.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-25.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-26.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-27.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-28.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-29.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-30.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-31.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-32.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-33.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-34.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-35.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-36.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-37.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-38.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-39.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-40.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-41.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-42.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-43.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-44.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-45.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-46.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-47.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-48.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-49.png']",
  "metrics": {
    "predict_time": 4.000483522,
    "total_time": 11.574494
  },
  "output": "https://replicate.delivery/xezq/genpHJKAHH1mB6ZwL6FfbsrlmYMxPyk3kIjFRXeZw4EqefMmC/output.mp4",
  "started_at": "2025-05-29T21:12:49.133010Z",
  "status": "succeeded",
  "urls": {
    "stream": "https://stream.replicate.com/v1/files/bcwr-oh3npxld67oqlnqqruf6fixj7hg5m3kxrak7wdwwwypiafi5xy7a",
    "get": "https://api.replicate.com/v1/predictions/n6k1qz6vaxrme0cq3qhsmk3tjc",
    "cancel": "https://api.replicate.com/v1/predictions/n6k1qz6vaxrme0cq3qhsmk3tjc/cancel"
  },
  "version": "6a1a60063eed12629dab0b811467eb3b89ed5557598c0c55348220f92ebb5796"
}

Generated in

4.0 seconds

Tweak it Iterate in playground ShareReport View full prediction

Output pattern detected
Sorted frame files: ['replicate-prediction-djce3905znrma0cq3pytmc4kbr-0.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-1.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-2.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-3.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-4.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-5.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-6.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-7.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-8.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-9.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-10.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-11.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-12.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-13.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-14.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-15.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-16.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-17.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-18.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-19.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-20.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-21.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-22.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-23.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-24.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-25.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-26.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-27.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-28.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-29.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-30.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-31.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-32.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-33.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-34.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-35.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-36.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-37.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-38.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-39.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-40.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-41.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-42.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-43.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-44.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-45.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-46.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-47.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-48.png', 'replicate-prediction-djce3905znrma0cq3pytmc4kbr-49.png']

This output was created using a different version of the model, onemadgeek/frames-to-video-merger:6a1a6006.

Examples

View more examples

Run time and cost

This model runs on CPU hardware. We don't yet have enough runs of this model to provide performance information.

Readme

This model doesn't have a readme.