# Seedance 2.5 Image to Video

> ByteDance Seedance 2.5 image-to-video via Fal.AI. Animates a single still into a native clip of up to 30 seconds at 480p/720p without the drift or stitching of multi-clip workflows, with optional end-frame control and synchronized audio generated in the same pass.

- **Provider**: fal
- **Model ID**: bytedance/seedance-2.5/image-to-video
- **Category**: video_generation
- **Credits**: 5500 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `duration` (string, **required**): Duration of the video in seconds (4-30). Required: upstream also accepts "auto", but the resulting length is unknown at request time and cannot be billed accurately, so this gateway requires an explicit duration. (Default: `5`; Options: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`)
- `aspect_ratio` (string, optional): The aspect ratio of the generated video. Always "auto" for image-to-video — the output follows the input image. (Default: `auto`; Options: `auto`)
- `image_url` (string, **required**): The URL of the starting frame image to animate. Supported formats: JPEG, PNG, WebP. Max 30 MB.
- `generate_audio` (boolean, optional): Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated. (Default: `True`)
- `prompt` (string, **required**): The text prompt describing the desired motion and action for the video. For dialogue, put the spoken words in double quotes.
- `end_image_url` (string, optional): The URL of the image to use as the last frame of the video. When provided, the generated video transitions from the starting image to this ending image.
- `resolution` (string, optional): Video resolution — 480p for faster generation, 720p for balance. (Default: `720p`; Options: `480p`, `720p`)

## Example Request

```json
{
  "model": "bytedance/seedance-2.5/image-to-video",
  "input": {
    "duration": "5",
    "generate_audio": true,
    "prompt": "An octopus finds a football in the ocean and excitedly calls its octopus friends to come and play. Cut scene to an octopus football game under the sea.",
    "resolution": "720p",
    "image_url": "https://v3b.fal.media/files/b/0a8eba37/Cqg-4Uwzyz4DELfceT1CF_a17e588773ec45b1a9e6f100a787b80b.jpg"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

bytedance, seedance, video-generation, image-to-video, native-audio, lip-sync

## Documentation

https://fal.ai/models/bytedance/seedance-2.5/image-to-video