Wan-2.1 Image-to-Video Image to Video

Readme

WAN-2.1 Image-to-Video: Transform Static Images into Dynamic Videos

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:

1. Get your API key at fal.ai/login
2. Install the SDK for your preferred language
3. Make your first API call

For JavaScript/TypeScript users:

javascript
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:

python
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:

javascript
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:

javascript
{
  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:

• Technical Documentation: fal.ai/models/fal-ai/wan-i2v/api
• API Status: status.fal.ai
• Support: support@fal.ai
• Discord Community: Join for real-time assistance

Ready to get started? Create your free account to get your API key.