Image-to-video
Overview
The image-to-video
pipeline of the AI Subnet allows you to generate animated
high-quality videos from images. This pipeline is powered by the latest
diffusion models in the HugginFace
image-to-video
pipeline.
Models
Warm Models
The current warm model requested for the image-to-video
pipeline is:
- stabilityai/stable-video-diffusion-img2vid-xt-1-1: An updated version of the stable-video-diffusion-img2vid-xt model with enhanced performance.
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 AI Subnet API
Reference.
To generate an image 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 image generation.- The
image
field holds the absolute path to the image file to be transformed.
For additional optional parameters, refer to the AI Subnet 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 image. Download the image
with:
curl -O "https://<STORAGE_ENDPOINT>/stream/2b835716/01c0e9a6.mp4"
API Reference
API Reference
Explore the image-to-video
endpoint and experiment with the API in the AI
Subnet API Reference.
Was this page helpful?