Skip to main content
Endpoint: POST https://fal.run/fal-ai/bytedance/seedance/v1/pro/image-to-video Endpoint ID: fal-ai/bytedance/seedance/v1/pro/image-to-video

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/bytedance/seedance/v1/pro/image-to-video",
    arguments={
        "prompt": "A skier glides over fresh snow, joyously smiling while kicking up large clouds of snow as he turns. Accelerating gradually down the slope, the camera moves smoothly alongside.",
        "image_url": "https://storage.googleapis.com/falserverless/example_inputs/seedance_pro_i2v_img.jpg"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
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(Proversion).Forotherresolutions,1millionvideotokenscosts0.74 (Pro version). For other resolutions, 1 million video tokens costs 3.0. The Lite version costs 0.18per720p5secondvideo,with1millionvideotokenscosting0.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 support@fal.ai for enterprise solutions.

​
Capabilities

  • Text prompt input
  • Aspect ratio control
  • Duration control
  • Reproducible generation (seed)
  • Safety checker
  • Frame count control
  • Image input

​
API Reference

​
Input Schema

​
prompt
string
required
The text prompt used to generate the video
​
aspect_ratio
AspectRatioEnum
default:"auto"
The aspect ratio of the generated video Default value: "auto"Possible values: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, auto
​
resolution
ResolutionEnum
default:"1080p"
Video resolution - 480p for faster generation, 720p for balance, 1080p for higher quality Default value: "1080p"Possible values: 480p, 720p, 1080p
​
duration
DurationEnum
default:"5"
Duration of the video in seconds Default value: "5"Possible values: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12
​
camera_fixed
boolean
default:"false"
Whether to fix the camera position
​
seed
integer
Random seed to control video generation. Use -1 for random.
​
enable_safety_checker
boolean
default:"true"
If set to true, the safety checker will be enabled. Default value: true
​
num_frames
integer
The number of frames to generate. If provided, will override duration.Range: 29 to 289
​
image_url
string
required
The URL of the image used to generate video
​
end_image_url
string
The URL of the image the video ends with. Defaults to None.

​
Output Schema

​
video
File
required
Generated video file
​
seed
integer
required
Seed used for generation

​
Input Example

{
  "prompt": "A skier glides over fresh snow, joyously smiling while kicking up large clouds of snow as he turns. Accelerating gradually down the slope, the camera moves smoothly alongside.",
  "aspect_ratio": "auto",
  "resolution": "1080p",
  "duration": "5",
  "camera_fixed": false,
  "enable_safety_checker": true,
  "image_url": "https://storage.googleapis.com/falserverless/example_inputs/seedance_pro_i2v_img.jpg"
}

​
Output Example

{
  "video": {
    "url": "https://storage.googleapis.com/falserverless/example_inputs/seedance_pro_i2v.mp4"
  },
  "seed": 42
}

​
Limitations

  • aspect_ratio restricted to: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, auto
  • resolution restricted to: 480p, 720p, 1080p
  • num_frames range: 29 to 289
  • Content moderation via safety checker