### Install Seedance 2.0 Python Client

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Install the fal-client library to use the Seedance 2.0 API with Python. This is the first step before making API calls.

```bash
pip install fal-client
```

--------------------------------

### Animate Image with Start-to-End Frame Transition

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create a video with a smooth transition between two images by providing both start and end image URLs. This example demonstrates setting a specific duration and aspect ratio.

```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/image-to-video",
    arguments={
        "prompt": "Smooth transition from day to night, the sky gradually darkens as city lights turn on.",
        "image_url": "https://example.com/day.jpg",
        "end_image_url": "https://example.com/night.jpg",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
    },
)
```

--------------------------------

### Generate Product Showcase Video

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create a product showcase video, such as for a smartphone. This example uses text-to-video with a prompt focused on a premium product, studio lighting, and a clean aesthetic.

```python
# Product showcase - smartphone
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A premium smartphone rotates slowly on a matte black surface, studio lighting reflecting off the glass edges. Camera orbits 360 degrees at eye level, then cuts to a macro shot of the camera module with lens flare. Minimal, clean aesthetic with soft gradient background shifting from deep navy to charcoal.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Install Seedance 2.0 JavaScript Client

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Install the @fal-ai/client npm package to use the Seedance 2.0 API with JavaScript. This is required before making API calls.

```bash
npm install @fal-ai/client
```

--------------------------------

### Generate Anime-Style Scene with Style Reference

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create an anime-style video using a style reference image. This example uses the reference-to-video endpoint and requires an image URL for style guidance.

```python
# Anime-style scene with style reference
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "In the style of @Image1, a young swordsman stands on a cliff edge overlooking a vast ocean at sunset. Wind catches his cloak and hair. He unsheathes a glowing blade and takes a battle stance. Camera sweeps from behind to a dramatic low-angle frontal shot. Vibrant anime color palette, dynamic action lines, cel-shaded lighting.",
        "image_urls": ["https://example.com/anime-style-ref.jpg"],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Nature Timelapse Video

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create a nature timelapse video using text-to-video. This example focuses on a mountain landscape transitioning from dawn to midday with dynamic weather effects.

```python
# Nature timelapse
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "Timelapse of a dramatic mountain landscape transitioning from dawn to midday. Fog rolls through the valley as the sun crests the peaks, casting long golden rays across alpine meadows. Clouds accelerate overhead in soft streaks. Camera holds steady on a wide establishing shot with a slow, barely perceptible zoom. Vivid natural colors, HDR dynamic range.",
        "resolution": "720p",
        "duration": "15",
        "aspect_ratio": "21:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Food Commercial Video

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generate a food commercial, like for coffee. This text-to-video example focuses on a cozy atmosphere, warm lighting, and close-up shots of the product.

```python
# Food commercial - coffee
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "Overhead shot of freshly brewed coffee being poured into a ceramic mug on a rustic wooden table. Steam rises in soft curls, catching warm morning sunlight from a nearby window. Camera slowly descends and pushes in to capture the swirl of cream being added. Warm color palette, shallow depth of field, cozy atmosphere.",
        "resolution": "720p",
        "duration": "8",
        "aspect_ratio": "4:3",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Lip-Synced Speaker Video

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create a talking head video with lip-syncing using a reference image and audio. This example uses the reference-to-video endpoint and requires image and audio URLs.

```python
# Lip-synced speaker with audio reference
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 speaks directly into the camera with confident, natural gestures. Professional studio setting with soft three-point lighting and a slightly blurred office background. Medium shot framing from the chest up, subtle head movements and eye contact throughout while delivering @Audio1.",
        "image_urls": ["https://example.com/speaker-headshot.jpg"],
        "audio_urls": ["https://example.com/voiceover.mp3"],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Dance Video with Motion Transfer

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Create a dance video using motion transfer from a reference video and a character image. This example uses the reference-to-video endpoint with image and video URLs.

```python
# Dance video with motion transfer and scene cuts
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 performs the choreography from @Video1 on a rain-soaked rooftop at night, neon signs reflecting in puddles. Camera tracks alongside the movement. Cut scene to a wide shot from above as the dancer hits the final pose, city lights stretching out below. High contrast, vibrant neon color grading, cinematic slow-motion on the final beat.",
        "image_urls": ["https://example.com/dancer.jpg"],
        "video_urls": ["https://example.com/choreography.mp4"],
        "resolution": "720p",
        "duration": "15",
        "aspect_ratio": "9:16",
        "generate_audio": True,
    },
)

```

--------------------------------

### Cinematic Trailer - Post-Apocalyptic

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generate a cinematic trailer with a post-apocalyptic theme. This example emphasizes detailed camera work, lighting, and filmic effects.

```python
# Cinematic trailer - post-apocalyptic
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "Slow dolly push in on a lone survivor standing atop a crumbled overpass, wind whipping dust across the frame. She stares into the distance at a ruined skyline, golden hour backlighting her silhouette. Camera drifts from a medium shot to a tight close-up on her face, catching the light in her eyes. Film grain, muted earth tones, anamorphic lens flare.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "21:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Video from Text Prompt (Python)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Use the fal-client library in Python to generate a video from a text prompt. Specify parameters like resolution, duration, aspect ratio, and audio generation.

```python
import fal_client

result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

print(result["video"]["url"])
```

--------------------------------

### Generate Video from Text Prompt (JavaScript)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Use the @fal-ai/client library in JavaScript to generate a video from a text prompt. Configure parameters such as resolution, duration, aspect ratio, and audio generation.

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

const result = await fal.subscribe("bytedance/seedance-2.0/text-to-video", {
  input: {
    prompt:
      "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
    resolution: "720p",
    duration: "10",
    aspect_ratio: "16:9",
    generate_audio: true,
  },
});

console.log(result.data.video.url);
```

--------------------------------

### Seedance 2.0 Text to Video (Standard Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video from a text prompt using the standard tier. Supports various resolutions, durations, aspect ratios, and optional audio generation.

```APIDOC
## POST /bytedance/seedance-2.0/text-to-video

### Description
Generates a video clip from a text prompt. This endpoint is part of the standard tier, offering higher quality output.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/text-to-video

### Parameters
#### Query Parameters
None

#### Request Body
- **prompt** (string) - Required - The text description for the video content.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".
- **generate_audio** (boolean) - Optional - Whether to generate synchronized audio. Defaults to false.

### Request Example
```json
{
  "prompt": "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
  "resolution": "720p",
  "duration": "10",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/video.mp4"
  }
}
```
```

--------------------------------

### Seedance 2.0 Text to Video (Fast Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video from a text prompt using the fast tier, offering a lower cost and faster generation time.

```APIDOC
## POST /bytedance/seedance-2.0/fast/text-to-video

### Description
Generates a video clip from a text prompt using the fast tier, providing a more cost-effective and quicker generation process.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/fast/text-to-video

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **prompt** (string) - Required - The text description for the video content.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".
- **generate_audio** (boolean) - Optional - Whether to generate synchronized audio. Defaults to false.

### Request Example
```json
{
  "prompt": "A fast-paced action scene in a futuristic city.",
  "resolution": "720p",
  "duration": "8",
  "aspect_ratio": "9:16",
  "generate_audio": true
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/fast_video.mp4"
  }
}
```
```

--------------------------------

### Lip-Sync with Audio Reference

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generate a talking-head video where the character's lip movements are synchronized with a provided audio reference.

```python
# Generate a talking-head video with lip-synced speech from an audio reference
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 speaks directly to the camera in a professional studio setting while saying @Audio1.",
        "image_urls": ["https://example.com/speaker.jpg"],
        "audio_urls": ["https://example.com/speech.mp3"],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Apply Visual Style from Reference Image

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Apply the visual style of a reference image to a generated video. This is useful for achieving a specific artistic look.

```python
# Apply the visual style of a reference image to generated video
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "A bustling Tokyo street scene at night in the style of @Image1, neon reflections on wet pavement.",
        "image_urls": ["https://example.com/art-style-reference.jpg"],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "21:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Generate Video from Text Prompt

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Use this snippet to generate a video based on a textual description. You can specify resolution, duration, aspect ratio, and whether to generate audio.

```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A timelapse of a flower blooming in a sunlit garden, soft bokeh background.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)
```

--------------------------------

### Multi-Scene Composition with Scene Cuts

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Control pacing and transitions in a video by using 'Cut scene to...' directives within the prompt for multi-scene videos.

```python
# Use scene cuts in the prompt to control pacing and transitions
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 finds a football in the ocean and picks it up excitedly. Cut scene to @Image1 calling friends over. Cut scene to a group of characters playing football underwater.",
        "image_urls": [
            "https://example.com/character.jpg",
        ],
        "resolution": "720p",
        "duration": "15",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Seedance 2.0 Image to Video (Fast Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video from a static image using the fast tier, offering a lower cost and faster generation time.

```APIDOC
## POST /bytedance/seedance-2.0/fast/image-to-video

### Description
Generates a video clip by animating a static image using the fast tier, providing a more cost-effective and quicker generation process.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/fast/image-to-video

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **image** (string) - Required - The base64 encoded image or URL of the image to animate.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".

### Request Example
```json
{
  "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
  "resolution": "720p",
  "duration": "12",
  "aspect_ratio": "1:1"
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/fast_animated_video.mp4"
  }
}
```
```

--------------------------------

### Seedance 2.0 Image to Video (Standard Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video from a static image using the standard tier. Supports various resolutions, durations, and aspect ratios.

```APIDOC
## POST /bytedance/seedance-2.0/image-to-video

### Description
Generates a video clip by animating a static image. This endpoint is part of the standard tier, offering higher quality output.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/image-to-video

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **image** (string) - Required - The base64 encoded image or URL of the image to animate.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".

### Request Example
```json
{
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...",
  "resolution": "720p",
  "duration": "10",
  "aspect_ratio": "16:9"
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/animated_video.mp4"
  }
}
```
```

--------------------------------

### Generate Video from Text Prompt (cURL)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Make a POST request using cURL to the Seedance 2.0 text-to-video endpoint. Ensure you include your API key and provide generation parameters in the JSON payload.

```bash
curl -X POST https://fal.run/bytedance/seedance-2.0/text-to-video \
  -H "Authorization: Key $FAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{ 
    "prompt": "A cinematic slow-motion shot of a golden eagle soaring through a mountain valley at sunrise.",
    "resolution": "720p",
    "duration": "10",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'
```

--------------------------------

### Seedance 2.0 Reference to Video (Standard Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video using multi-modal references (image, video, audio) with the standard tier. Supports various resolutions, durations, and aspect ratios.

```APIDOC
## POST /bytedance/seedance-2.0/reference-to-video

### Description
Generates a video clip using multi-modal references, including image, video, and audio inputs. This endpoint is part of the standard tier, offering higher quality output.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/reference-to-video

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **image** (string) - Optional - The base64 encoded image or URL of the image reference.
- **video** (string) - Optional - The URL of the video reference.
- **audio** (string) - Optional - The URL of the audio reference.
- **prompt** (string) - Optional - A text prompt to guide the generation.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".

### Request Example
```json
{
  "image": "https://example.com/path/to/reference_image.jpg",
  "audio": "https://example.com/path/to/reference_audio.mp3",
  "prompt": "A scene inspired by the provided image and audio.",
  "resolution": "720p",
  "duration": "15",
  "aspect_ratio": "16:9"
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/reference_video.mp4"
  }
}
```
```

--------------------------------

### Full Multi-Modal Generation

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Combine image for character, video for motion, and audio for soundtrack in a single generation request for comprehensive multi-modal output.

```python
# Combine all modalities: image for character, video for motion, audio for soundtrack
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 performs the choreography from @Video1 on stage while @Audio1 plays in the background.",
        "image_urls": ["https://example.com/performer.jpg"],
        "video_urls": ["https://example.com/choreography.mp4"],
        "audio_urls": ["https://example.com/track.mp3"],
        "resolution": "720p",
        "duration": "15",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Seedance 2.0 Reference to Video (Fast Tier)

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates video using multi-modal references with the fast tier, offering a lower cost and faster generation time.

```APIDOC
## POST /bytedance/seedance-2.0/fast/reference-to-video

### Description
Generates a video clip using multi-modal references (image, video, audio) with the fast tier, providing a more cost-effective and quicker generation process. A 0.6x price multiplier applies for video inputs.

### Method
POST

### Endpoint
https://fal.run/bytedance/seedance-2.0/fast/reference-to-video

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **image** (string) - Optional - The base64 encoded image or URL of the image reference.
- **video** (string) - Optional - The URL of the video reference.
- **audio** (string) - Optional - The URL of the audio reference.
- **prompt** (string) - Optional - A text prompt to guide the generation.
- **resolution** (string) - Optional - The desired resolution for the video (e.g., "480p", "720p"). Defaults to "480p".
- **duration** (string) - Optional - The desired duration of the video in seconds (e.g., "4", "10", "15"). Defaults to "4".
- **aspect_ratio** (string) - Optional - The desired aspect ratio of the video (e.g., "16:9", "9:16", "1:1"). Defaults to "16:9".

### Request Example
```json
{
  "video": "https://example.com/path/to/reference_video.mp4",
  "prompt": "Continue the action from the reference video.",
  "resolution": "720p",
  "duration": "15",
  "aspect_ratio": "21:9"
}
```

### Response
#### Success Response (200)
- **video** (object) - Contains information about the generated video.
  - **url** (string) - The URL to access the generated video.

#### Response Example
```json
{
  "video": {
    "url": "https://example.com/path/to/your/fast_reference_video.mp4"
  }
}
```
```

--------------------------------

### Animate Image with Motion and Audio

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Animate a static image by providing a motion prompt and an image URL. This snippet allows for specifying resolution, duration, aspect ratio, and audio generation.

```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/image-to-video",
    arguments={
        "prompt": "She slowly turns to face the camera, wind catching her hair.",
        "image_url": "https://example.com/portrait.jpg",
        "resolution": "720p",
        "duration": "8",
        "aspect_ratio": "auto",
        "generate_audio": True,
    },
)
```

--------------------------------

### Text to Video Generation

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Generates a video from a text prompt. Supports various resolutions, durations, aspect ratios, and audio generation.

```APIDOC
## Text to Video Generation

### Description
Generates video from a text prompt.

### Model IDs
`bytedance/seedance-2.0/text-to-video` | `bytedance/seedance-2.0/fast/text-to-video`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **prompt** (string) - Required - Text description of the video to generate
- **resolution** (string) - Optional - "480p" or "720p"
- **duration** (string) - Optional - "auto" or "4" through "15" seconds
- **aspect_ratio** (string) - Optional - "auto", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"
- **generate_audio** (boolean) - Optional - Generate synchronized audio
- **seed** (integer) - Optional - Random seed for reproducibility
- **end_user_id** (string) - Optional - Unique identifier for end-user tracking

### Request Example
```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A timelapse of a flower blooming in a sunlit garden, soft bokeh background.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)
```

### Response
#### Success Response (200)
(Response details not provided in source)

#### Response Example
(Response example not provided in source)
```

--------------------------------

### Image to Video Generation

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Animates a static image with motion, physics, and optional audio. Supports start-to-end frame transitions.

```APIDOC
## Image to Video Generation

### Description
Animate a static image with motion, physics, and optional audio.

### Model IDs
`bytedance/seedance-2.0/image-to-video` | `bytedance/seedance-2.0/fast/image-to-video`

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **prompt** (string) - Required - Text description of the desired motion
- **image_url** (string) - Required - URL of the starting frame image (JPEG, PNG, WebP, max 30 MB)
- **end_image_url** (string) - Optional - URL of the ending frame for start-to-end transitions
- **resolution** (string) - Optional - "480p" or "720p"
- **duration** (string) - Optional - "auto" or "4" through "15" seconds
- **aspect_ratio** (string) - Optional - "auto", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"
- **generate_audio** (boolean) - Optional - Generate synchronized audio
- **seed** (integer) - Optional - Random seed for reproducibility
- **end_user_id** (string) - Optional - Unique identifier for end-user tracking

### Request Example (Basic)
```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/image-to-video",
    arguments={
        "prompt": "She slowly turns to face the camera, wind catching her hair.",
        "image_url": "https://example.com/portrait.jpg",
        "resolution": "720p",
        "duration": "8",
        "aspect_ratio": "auto",
        "generate_audio": True,
    },
)
```

### Request Example (Start-to-End Frame Transition)
```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/image-to-video",
    arguments={
        "prompt": "Smooth transition from day to night, the sky gradually darkens as city lights turn on.",
        "image_url": "https://example.com/day.jpg",
        "end_image_url": "https://example.com/night.jpg",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
    },
)
```

### Response
#### Success Response (200)
(Response details not provided in source)

#### Response Example
(Response example not provided in source)
```

--------------------------------

### Set FAL API Key Environment Variable

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Set your fal API key as an environment variable to authenticate with the API. Client libraries automatically read this variable.

```bash
export FAL_KEY="your_fal_api_key"
```

--------------------------------

### Generate Film Noir Detective Scene

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Use this snippet to generate a film noir-style video with a detective character. Requires specifying a detailed prompt, resolution, duration, aspect ratio, and whether to generate audio.

```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/text-to-video",
    arguments={
        "prompt": "A hard-faced detective in a long coat stands under a flickering streetlamp on a rain-soaked city street. He lights a cigarette, the flame briefly illuminating his scarred jawline. Camera starts wide, slowly pushing in as rain streaks catch the neon light from a bar sign behind him. High contrast black and white, deep shadows, 35mm grain.",
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Transfer Motion from Video Reference

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Transfer motion from a reference video onto a character defined by an image. This allows for animating static images with dynamic movements.

```python
# Transfer motion from a reference video onto a character from an image
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 performs the dance moves from @Video1 on a rooftop at sunset.",
        "image_urls": ["https://example.com/dancer.jpg"],
        "video_urls": ["https://example.com/dance-reference.mp4"],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Reference to Video (Omni-Modal) Generation

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

The most powerful Seedance 2.0 endpoint. Generates video conditioned on any combination of reference images, videos, and audio.

```APIDOC
## Reference to Video (Omni-Modal) Generation

### Description
Generate video conditioned on any combination of reference images, videos, and audio - style transfer, lip-sync, motion transfer, character consistency, and scene composition all in one model.

Use `@Image1`, `@Video1`, `@Audio1` syntax in your prompt to reference inputs. Use scene cuts and timestamps to control pacing (e.g. "Cut scene to...", "At 5 seconds...").

### Model IDs
`bytedance/seedance-2.0/reference-to-video` | `bytedance/seedance-2.0/fast/reference-to-video`

### Capabilities
Stylized generation, style transfer, lip-sync, motion transfer, character consistency, multi-scene composition

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **prompt** (string) - Required - Text prompt with `@Image1`, `@Video1`, `@Audio1` references. Supports scene cuts and timestamps for pacing control.
- **image_urls** (list<string>) - Optional - Up to 9 reference images (JPEG, PNG, WebP, max 30 MB each)
- **video_urls** (list<string>) - Optional - Up to 3 reference videos (MP4, MOV, 2-15s combined, max 50 MB, ~480p-720p resolution)
- **audio_urls** (list<string>) - Optional - Up to 3 audio files (MP3, WAV, max 15s combined, max 15 MB each). Requires at least one reference image or video.
- **resolution** (string) - Optional - "480p" or "720p"
- **duration** (string) - Optional - "auto" or "4" through "15" seconds
- **aspect_ratio** (string) - Optional - "auto", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"
- **generate_audio** (boolean) - Optional - Generate synchronized audio including sound effects, ambient sounds, and lip-synced speech
- **seed** (integer) - Optional - Random seed for reproducibility
- **end_user_id** (string) - Optional - Unique identifier for end-user tracking

> Total files across all modalities must not exceed 12. Video inputs receive a **0.6x price multiplier**.

### Request Example (Character-Consistent Generation)
(Request example not provided in source)

### Response
#### Success Response (200)
(Response details not provided in source)

#### Response Example
(Response example not provided in source)
```

--------------------------------

### Maintain Character Identity Across Scenes

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

Use an image reference to ensure a consistent character appearance throughout multiple scenes in a generated video.

```python
result = fal_client.subscribe(
    "bytedance/seedance-2.0/reference-to-video",
    arguments={
        "prompt": "@Image1 walks confidently down a neon-lit city street at night, camera tracking alongside.",
        "image_urls": [
            "https://example.com/character.jpg",
        ],
        "resolution": "720p",
        "duration": "10",
        "aspect_ratio": "16:9",
        "generate_audio": True,
    },
)

```

--------------------------------

### Seedance 2.0 API Response Format

Source: https://github.com/fal-ai/seedance-2.0-api/blob/main/README.md

All endpoints return a consistent JSON structure containing the output video URL and a seed value.

```json
{
  "video": {
    "url": "https://v3b.fal.media/files/output/video.mp4"
  },
  "seed": 42
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.