Readme
Transform your static images into fluid, natural-looking videos with WAN-2.1 Image-to-Video. This powerful API lets you create engaging video content from single images with professional-grade motion and high visual quality.
Overview
WAN-2.1 Image-to-Video uses advanced AI to analyze your source image and generate realistic motion, perfect for:
- Creating engaging social media content
- Bringing product photographs to life
- Generating dynamic presentation assets
- Adding movement to architectural visualizations
- Converting portraits into brief video sequences
Getting Started
Getting up and running takes just a few minutes. Here's how to begin:
- Get your API key at fal.ai/login
- Install the SDK for your preferred language
- Make your first API call
For JavaScript/TypeScript users:
import { fal } from "@fal-ai/client";
// Configure your credentials
fal.config({
credentials: "YOUR_FAL_KEY"
});
// Generate video from image
const result = await fal.subscribe("fal-ai/wan-i2v", {
input: {
image_url: "YOUR_IMAGE_URL",
prompt: "Cars racing in slow motion"
}
});
For Python developers:
import fal_client
result = fal_client.subscribe("fal-ai/wan-i2v", {
"image_url": "YOUR_IMAGE_URL",
"prompt": "Cars racing in slow motion"
})
Technical Specifications
Video Output:
- Resolution: 480p or 720p
- Duration: 81-100 frames (approximately 5-6 seconds at 16 FPS)
- Format: MP4 with H.264 encoding
- Frame Rate: 5-24 FPS (default: 16 FPS)
- Aspect Ratio: auto, 16:9, 9:16, or 1:1
Processing:
- Average Generation Time: Approximately 1 minute
- Real-time Progress Updates
- Webhook Support for Completion Notifications
Best Practices
Achieve optimal results by following these guidelines:
Image Selection
Clear, high-quality source images produce better results. Use images with good lighting and sharp focus. Complex scenes with multiple subjects may require prompt adjustment.
Parameter Optimization
Start with default settings and adjust based on your needs. Use higher resolution (720p) for better quality at higher cost. Adjust frames_per_second for smoother or more stylized motion.
Error Handling
Implement proper error handling in your code:
try {
const result = await fal.subscribe("fal-ai/wan-i2v", {
input: {
image_url: imageUrl,
prompt: "Your motion description"
}
});
} catch (error) {
console.error("Video generation failed:", error.message);
}
API Reference
Core Parameters:
{
prompt: string, // Required: Motion description
image_url: string, // Required: URL or base64 image
num_frames: number, // Optional: 81-100 (default 81)
frames_per_second: number, // Optional: 5-24 (default 16)
resolution: string, // Optional: "480p"|"720p" (default "720p")
aspect_ratio: string, // Optional: "auto"|"16:9"|"9:16"|"1:1"
enable_safety_checker: boolean,
enable_prompt_expansion: boolean
}
Pricing and Usage
Transparent, usage-based pricing:
- 480p resolution: $0.20 per video (0.5 billing units)
- 720p resolution: $0.40 per video (1 billing unit)
- Videos with >81 frames: 1.25x billing units
- Pay-per-use model with no subscription required
View detailed pricing or contact sales for enterprise solutions.
Migration Guide
Coming from Replicate? Our API offers a similar interface with enhanced capabilities:
- Higher quality output with motion diversity
- More precise motion control
- Faster processing times
- Simplified error handling
- Extensive SDK support
Support and Resources
We're here to help you succeed:
Ready to get started? Create your free account to get your API key.
fal-ai/wan-i2v
