# Seedance 2.5 Text to Video

> ByteDance Seedance 2.5 text-to-video via Fal.AI. Generates a native single-shot clip of up to 30 seconds at 480p/720p from a text prompt alone, reasoning about the whole shot at once so motion, lighting, and subject identity stay coherent from first frame to last. Synchronized audio (dialogue, sound effects, music) is generated in the same pass.

- **Provider**: fal
- **Model ID**: bytedance/seedance-2.5/text-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. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. (Default: `auto`; Options: `auto`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`)
- `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 used to generate the video. For dialogue, put the spoken words in double quotes — the model generates matching lip movements and voice.
- `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/text-to-video",
  "input": {
    "duration": "5",
    "aspect_ratio": "auto",
    "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"
  }
}
```

## 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, text-to-video, native-audio, lip-sync

## Documentation

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