Overview

The image-to-video pipeline of the Livepeer AI network allows you to generate animated high-quality videos from images. This pipeline is powered by the latest diffusion models in the HuggingFace image-to-video pipeline.

Models

Warm Models

The current warm model requested for the image-to-video pipeline is:

For faster responses with different image-to-video diffusion models, ask Orchestrators to load it on their GPU via the ai-video channel in Discord Server.

On-Demand Models

The following models have been tested and verified for the image-to-video pipeline:

If a specific model you wish to use is not listed, please submit a feature request on GitHub to get the model verified and added to the list.

Basic Usage Instructions

For a detailed understanding of the image-to-video endpoint and to experiment with the API, see the Livepeer AI API Reference.

To generate a video with the image-to-video pipeline, send a POST request to the Gateway’s image-to-video API endpoint:

curl -X POST "https://<GATEWAY_IP>/image-to-video" \
    -F model_id=stabilityai/stable-video-diffusion-img2vid-xt-1-1 \
    -F image=@<PATH_TO_IMAGE>

In this command:

  • <GATEWAY_IP> should be replaced with your AI Gateway’s IP address.
  • model_id is the diffusion model for video generation.
  • The image field holds the absolute path to the image file to be transformed.

For additional optional parameters, refer to the Livepeer AI API Reference.

After execution, the Orchestrator processes the request and returns the response to the Gateway:

{
  "images": [
    {
      "nsfw": false,
      "seed": 1914955328,
      "url": "/stream/2b835716/01c0e9a6.mp4"
    }
  ]
}

The url in the response is the URL of the generated video. Download the video with:

curl -O "https://<STORAGE_ENDPOINT>/stream/2b835716/01c0e9a6.mp4"

Orchestrator Configuration

To configure your Orchestrator to serve the image-to-video pipeline, refer to the Orchestrator Configuration guide.

System Requirements

The following system requirements are recommended for optimal performance:

API Reference

API Reference

Explore the image-to-video endpoint and experiment with the API in the Livepeer AI API Reference.