Readme

Seedance: Professional Image-to-Video Generation

Transform static images into fluid, natural-looking videos with Seedance, ByteDance's advanced AI motion generation model. Whether you're creating engaging social media content, dynamic marketing materials, or creative visual projects, Seedance helps you bring your images to life with sophisticated motion synthesis.

Key Capabilities

Seedance excels at creating natural motion from single images while preserving visual quality and temporal consistency. The model understands complex scenes and generates realistic movement patterns that respect physical constraints and object relationships.

Create compelling video content from:

• Portrait photos with natural facial expressions and movements
• Landscape scenes with flowing water, swaying trees, and dynamic skies
• Product shots with smooth rotations and transitions
• Abstract art with creative motion effects

Getting Started

Setting up Seedance is straightforward. First, install the fal client library:

# For Node.js
npm install --save @fal-ai/client

# For Python
pip install fal-client

Configure your API credentials:

import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY_HERE"
});

Making Your First API Call

Generate your first video with this simple example:

const result = await fal.subscribe("fal-ai/bytedance/seedance/v1/pro/image-to-video", {
  input: {
    image_url: "YOUR_IMAGE_URL"
  }
});

Advanced Usage

Seedance offers fine-grained control over video generation through various parameters:

Motion Control

Control the intensity and nature of movement with configurable parameters. The model features a wide dynamic range, enabling smooth generation of large-scale movements while maintaining stability and physical realism.

Duration and Quality

Adjust video length and quality settings to match your needs. The Pro model supports 1080p output, while the Lite model provides 720p resolution. Both models typically generate 5-second videos.

Best Practices

For optimal results:

• Use high-quality source images with good lighting and clear subjects
• Accepted file types include: jpg, jpeg, png, webp, gif, avif
• Consider the intended motion when composing your input image
• Start with default parameters and adjust gradually
• Test different configurations to find the right balance for your content

Technical Specifications

Processing Capabilities:

• Input Resolution: Supports various input formats and sizes
• Output Formats: MP4 video
• Output Resolution: Up to 1080p (Pro), 720p (Lite)
• Frame Rate: Standard video frame rates
• Processing Time: Varies based on complexity and queue

Pricing and Usage

Each 1080p 5 second video costs roughly $0.74 (Pro version). For other resolutions, 1 million video tokens costs $3.0. The Lite version costs $0.18 per 720p 5 second video, with 1 million video tokens costing $1.8.

Pricing calculation: tokens(video) = (height x width x FPS x duration) / 1024

Our transparent, usage-based pricing scales with your needs:

• Pay-per-use model with no subscription required
• Pro version for high-quality 1080p output
• Lite version for cost-effective 720p generation
• No hidden fees or minimum commitments

Implementation Support

Our comprehensive support resources help you integrate Seedance successfully:

Documentation

Access detailed API references, code examples, and integration guides in our documentation portal at docs.fal.ai

Client Libraries

We have support via official client libraries for JavaScript, Python, Swift, Java, Kotlin, and Dart (Flutter)

Sample Applications

Explore reference implementations and example projects demonstrating common use cases and implementation patterns

For detailed pricing information, visit fal.ai/pricing or contact [email protected] for enterprise solutions.