# Seedance 2.0

> Generate cinematic AI videos with native audio, multi-shot storytelling, and omni-reference control using ByteDance Seedance 2.0.


## Overview

- **Endpoint**: `https://api.segmind.com/v1/seedance-2.0`
- **Model ID**: `seedance-2.0`
- **Category**: Image-to-Video Generation
- **Type**: Synchronous (Direct response)

- **Average Cost**: $1.2124749569620252


## Pricing

| input_type | input_tokens | output_tokens |
| --- | --- | --- |
| Text or image input | Free | $7.0 per million tokens |
| Video input | Free | $4.3 per million tokens |

## API Information

This model uses a **synchronous response pattern**:
1. Make a POST request with your parameters
2. Receive the output directly in the response (binary for images/videos/audio, JSON for text)
3. No polling required - response is immediate


### Input Schema

The API accepts the following input parameters:

- **`prompt`** (`string`, _required_):
  Prompt
  - Default: `""`

- **`first_frame_url`** (`File (URL)`, _optional_):
  First frame uRL
  - Default: `""`

- **`last_frame_url`** (`File (URL)`, _optional_):
  Last frame uRL
  - Default: `""`

- **`reference_images`** (`array`, _optional_):
  Reference images
  - Item type: string

- **`reference_videos`** (`array`, _optional_):
  Reference videos
  - Item type: string

- **`reference_audios`** (`array`, _optional_):
  Reference audios
  - Item type: string

- **`duration`** (`integer | null`, _optional_):
  Duration
  - Default: `10`
  - Options: "4" (4), "5" (5), "6" (6), "8" (8), "10" (10), "12" (12), "15" (15)
  - Range: 4 to 15

- **`resolution`** (`string | null`, _optional_):
  Resolution
  - Default: `"720p"`
  - Options: "480p" (480p), "720p" (720p), "1080p" (1080p)

- **`aspect_ratio`** (`string | null`, _optional_):
  Aspect ratio
  - Default: `"16:9"`
  - Options: "16:9" (16:9), "9:16" (9:16), "1:1" (1:1), "4:3" (4:3), "3:4" (3:4), "21:9" (21:9), "adaptive" (adaptive)

- **`generate_audio`** (`boolean | null`, _optional_):
  Generate audio
  - Default: `false`

- **`seed`** (`integer | null`, _optional_):
  Seed
  - Default: `42`
  - Range: -1 to 2147483647

- **`return_last_frame`** (`boolean | null`, _optional_):
  Return last frame
  - Default: `false`


**Required Parameters Example**:

```json
{
  "prompt": "Generate a 16:9 aspect ratio video featuring top attractive Asian male and female leads, created according to the following shot script:\nShot 1 | 0s–1s\nMedium shot, static camera. Camera is stable, no movement. The man and woman sit inside a red convertible, looking forward in profile, expressions cold and composed. No effects. Dark tones dominate, atmosphere heavy and somber.\nShot 2 | 1s–2s\nWide/full shot, static camera. Camera stable, no movement. The woman sits on the car door, the man leans against the car body removing his jacket, gesture bold and dramatic. Hard cut transition. Red and black contrast, full of street rebellious energy.\nShot 3 | 2s–3s\nClose shot, static camera. No movement. The male lead wears sunglasses and stares directly into the camera; the female lead lightly brushes her hair aside. Hard cut transition. Red-black tones, mood cold and fierce.\nShot 4 | 3s–4s\nExtreme close-up, static camera. Fixed position. The car's rearview mirror reflects the female lead's face, her gaze distant and dreamy. Mirror reflection effect. Cool color tones, emphasizing loneliness.\nShot 5 | 4s–5s\nMedium shot, low-angle (upward tilt), static camera. Fixed position. The male lead in a white tank top smokes a cigarette, tilts his head looking into the distance, expression indifferent. No effects. Cool gray background, mood listless and detached.\nShot 6 | 5s–7s\nMedium shot, side tracking shot. Camera moves laterally at the same speed as the vehicle, conveying a sense of motion. Both are on a night drive, the woman turns her head to look at the man, expression natural and relaxed. Background dynamic blur. Night scenery with neon lights, mood relaxed and easy.\nShot 7 | 7s–9s\nMedium shot, front-facing tracking shot. Camera retreats at vehicle speed, strong sense of forward momentum. The female lead steers with one hand and makes a gesture; the male lead lounges casually in his seat. Background car light bokeh blur. Rich colors, mood free and uninhibited.\nShot 8 | 9s–14s\nClose shot, static camera. Fixed position. The female lead tilts her head back against the seat; the male lead wears sunglasses and gazes ahead, expression distant and detached. Subtitles appear at the bottom of the frame. Red-black palette, mood returns to solitude and exhaustion."
}
```


**Full Example**:

```json
{
  "prompt": "Generate a 16:9 aspect ratio video featuring top attractive Asian male and female leads, created according to the following shot script:\nShot 1 | 0s–1s\nMedium shot, static camera. Camera is stable, no movement. The man and woman sit inside a red convertible, looking forward in profile, expressions cold and composed. No effects. Dark tones dominate, atmosphere heavy and somber.\nShot 2 | 1s–2s\nWide/full shot, static camera. Camera stable, no movement. The woman sits on the car door, the man leans against the car body removing his jacket, gesture bold and dramatic. Hard cut transition. Red and black contrast, full of street rebellious energy.\nShot 3 | 2s–3s\nClose shot, static camera. No movement. The male lead wears sunglasses and stares directly into the camera; the female lead lightly brushes her hair aside. Hard cut transition. Red-black tones, mood cold and fierce.\nShot 4 | 3s–4s\nExtreme close-up, static camera. Fixed position. The car's rearview mirror reflects the female lead's face, her gaze distant and dreamy. Mirror reflection effect. Cool color tones, emphasizing loneliness.\nShot 5 | 4s–5s\nMedium shot, low-angle (upward tilt), static camera. Fixed position. The male lead in a white tank top smokes a cigarette, tilts his head looking into the distance, expression indifferent. No effects. Cool gray background, mood listless and detached.\nShot 6 | 5s–7s\nMedium shot, side tracking shot. Camera moves laterally at the same speed as the vehicle, conveying a sense of motion. Both are on a night drive, the woman turns her head to look at the man, expression natural and relaxed. Background dynamic blur. Night scenery with neon lights, mood relaxed and easy.\nShot 7 | 7s–9s\nMedium shot, front-facing tracking shot. Camera retreats at vehicle speed, strong sense of forward momentum. The female lead steers with one hand and makes a gesture; the male lead lounges casually in his seat. Background car light bokeh blur. Rich colors, mood free and uninhibited.\nShot 8 | 9s–14s\nClose shot, static camera. Fixed position. The female lead tilts her head back against the seat; the male lead wears sunglasses and gazes ahead, expression distant and detached. Subtitles appear at the bottom of the frame. Red-black palette, mood returns to solitude and exhaustion.",
  "first_frame_url": "",
  "last_frame_url": "",
  "reference_images": [],
  "reference_videos": [],
  "reference_audios": [],
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "seed": 42,
  "return_last_frame": false
}
```


### Output Schema

The API returns a synchronous response based on the model type:

**For Image/Video/Audio Models**:
- Response contains binary data (image/png, video/mp4, audio/mp3)
- Content-Type header indicates the media type
- Save the response body directly to a file

**For Text Models**:
- Response is JSON with the generated text
- Structure varies by model

**HTTP Response Codes**:
- **200 - OK**: Request successful, output in response body
- **400 - Bad Request**: Invalid parameters
- **401 - Unauthorized**: Invalid or missing API key
- **404 - Not Found**: Model not found
- **406 - Not Acceptable**: Insufficient credits
- **429 - Too Many Requests**: Rate limit exceeded
- **500 - Server Error**: Internal server error


## Usage Examples

### cURL

```bash
curl -X POST "https://api.segmind.com/v1/seedance-2.0" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Generate a 16:9 aspect ratio video featuring top attractive Asian male and female leads, created according to the following shot script:\nShot 1 | 0s–1s\nMedium shot, static camera. Camera is stable, no movement. The man and woman sit inside a red convertible, looking forward in profile, expressions cold and composed. No effects. Dark tones dominate, atmosphere heavy and somber.\nShot 2 | 1s–2s\nWide/full shot, static camera. Camera stable, no movement. The woman sits on the car door, the man leans against the car body removing his jacket, gesture bold and dramatic. Hard cut transition. Red and black contrast, full of street rebellious energy.\nShot 3 | 2s–3s\nClose shot, static camera. No movement. The male lead wears sunglasses and stares directly into the camera; the female lead lightly brushes her hair aside. Hard cut transition. Red-black tones, mood cold and fierce.\nShot 4 | 3s–4s\nExtreme close-up, static camera. Fixed position. The car's rearview mirror reflects the female lead's face, her gaze distant and dreamy. Mirror reflection effect. Cool color tones, emphasizing loneliness.\nShot 5 | 4s–5s\nMedium shot, low-angle (upward tilt), static camera. Fixed position. The male lead in a white tank top smokes a cigarette, tilts his head looking into the distance, expression indifferent. No effects. Cool gray background, mood listless and detached.\nShot 6 | 5s–7s\nMedium shot, side tracking shot. Camera moves laterally at the same speed as the vehicle, conveying a sense of motion. Both are on a night drive, the woman turns her head to look at the man, expression natural and relaxed. Background dynamic blur. Night scenery with neon lights, mood relaxed and easy.\nShot 7 | 7s–9s\nMedium shot, front-facing tracking shot. Camera retreats at vehicle speed, strong sense of forward momentum. The female lead steers with one hand and makes a gesture; the male lead lounges casually in his seat. Background car light bokeh blur. Rich colors, mood free and uninhibited.\nShot 8 | 9s–14s\nClose shot, static camera. Fixed position. The female lead tilts her head back against the seat; the male lead wears sunglasses and gazes ahead, expression distant and detached. Subtitles appear at the bottom of the frame. Red-black palette, mood returns to solitude and exhaustion.",
  "first_frame_url": "",
  "last_frame_url": "",
  "reference_images": [],
  "reference_videos": [],
  "reference_audios": [],
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "seed": 42,
  "return_last_frame": false
}'
```

### Python

```python
import requests
import json

api_key = "YOUR_API_KEY"
url = "https://api.segmind.com/v1/seedance-2.0"

data = {
  "prompt": "Generate a 16:9 aspect ratio video featuring top attractive Asian male and female leads, created according to the following shot script:\nShot 1 | 0s–1s\nMedium shot, static camera. Camera is stable, no movement. The man and woman sit inside a red convertible, looking forward in profile, expressions cold and composed. No effects. Dark tones dominate, atmosphere heavy and somber.\nShot 2 | 1s–2s\nWide/full shot, static camera. Camera stable, no movement. The woman sits on the car door, the man leans against the car body removing his jacket, gesture bold and dramatic. Hard cut transition. Red and black contrast, full of street rebellious energy.\nShot 3 | 2s–3s\nClose shot, static camera. No movement. The male lead wears sunglasses and stares directly into the camera; the female lead lightly brushes her hair aside. Hard cut transition. Red-black tones, mood cold and fierce.\nShot 4 | 3s–4s\nExtreme close-up, static camera. Fixed position. The car's rearview mirror reflects the female lead's face, her gaze distant and dreamy. Mirror reflection effect. Cool color tones, emphasizing loneliness.\nShot 5 | 4s–5s\nMedium shot, low-angle (upward tilt), static camera. Fixed position. The male lead in a white tank top smokes a cigarette, tilts his head looking into the distance, expression indifferent. No effects. Cool gray background, mood listless and detached.\nShot 6 | 5s–7s\nMedium shot, side tracking shot. Camera moves laterally at the same speed as the vehicle, conveying a sense of motion. Both are on a night drive, the woman turns her head to look at the man, expression natural and relaxed. Background dynamic blur. Night scenery with neon lights, mood relaxed and easy.\nShot 7 | 7s–9s\nMedium shot, front-facing tracking shot. Camera retreats at vehicle speed, strong sense of forward momentum. The female lead steers with one hand and makes a gesture; the male lead lounges casually in his seat. Background car light bokeh blur. Rich colors, mood free and uninhibited.\nShot 8 | 9s–14s\nClose shot, static camera. Fixed position. The female lead tilts her head back against the seat; the male lead wears sunglasses and gazes ahead, expression distant and detached. Subtitles appear at the bottom of the frame. Red-black palette, mood returns to solitude and exhaustion.",
  "first_frame_url": "",
  "last_frame_url": "",
  "reference_images": [],
  "reference_videos": [],
  "reference_audios": [],
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "seed": 42,
  "return_last_frame": false
}

response = requests.post(
    url,
    json=data,
    headers={
        'Authorization': f'Bearer {api_key}',
        'Content-Type': 'application/json'
    }
)

if response.status_code == 200:
    # For image/video/audio models, response.content contains the binary data
    with open('output.png', 'wb') as f:
        f.write(response.content)
    print('Generation complete, saved to output.png')
else:
    print(f"Error: {response.status_code}")
    print(response.text)
```

### JavaScript

```javascript
const apiKey = 'YOUR_API_KEY';
const url = 'https://api.segmind.com/v1/seedance-2.0';

const data = {
  "prompt": "Generate a 16:9 aspect ratio video featuring top attractive Asian male and female leads, created according to the following shot script:\nShot 1 | 0s–1s\nMedium shot, static camera. Camera is stable, no movement. The man and woman sit inside a red convertible, looking forward in profile, expressions cold and composed. No effects. Dark tones dominate, atmosphere heavy and somber.\nShot 2 | 1s–2s\nWide/full shot, static camera. Camera stable, no movement. The woman sits on the car door, the man leans against the car body removing his jacket, gesture bold and dramatic. Hard cut transition. Red and black contrast, full of street rebellious energy.\nShot 3 | 2s–3s\nClose shot, static camera. No movement. The male lead wears sunglasses and stares directly into the camera; the female lead lightly brushes her hair aside. Hard cut transition. Red-black tones, mood cold and fierce.\nShot 4 | 3s–4s\nExtreme close-up, static camera. Fixed position. The car's rearview mirror reflects the female lead's face, her gaze distant and dreamy. Mirror reflection effect. Cool color tones, emphasizing loneliness.\nShot 5 | 4s–5s\nMedium shot, low-angle (upward tilt), static camera. Fixed position. The male lead in a white tank top smokes a cigarette, tilts his head looking into the distance, expression indifferent. No effects. Cool gray background, mood listless and detached.\nShot 6 | 5s–7s\nMedium shot, side tracking shot. Camera moves laterally at the same speed as the vehicle, conveying a sense of motion. Both are on a night drive, the woman turns her head to look at the man, expression natural and relaxed. Background dynamic blur. Night scenery with neon lights, mood relaxed and easy.\nShot 7 | 7s–9s\nMedium shot, front-facing tracking shot. Camera retreats at vehicle speed, strong sense of forward momentum. The female lead steers with one hand and makes a gesture; the male lead lounges casually in his seat. Background car light bokeh blur. Rich colors, mood free and uninhibited.\nShot 8 | 9s–14s\nClose shot, static camera. Fixed position. The female lead tilts her head back against the seat; the male lead wears sunglasses and gazes ahead, expression distant and detached. Subtitles appear at the bottom of the frame. Red-black palette, mood returns to solitude and exhaustion.",
  "first_frame_url": "",
  "last_frame_url": "",
  "reference_images": [],
  "reference_videos": [],
  "reference_audios": [],
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "seed": 42,
  "return_last_frame": false
};

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(data),
});

if (response.ok) {
  // For image/video/audio models, response contains binary data
  const blob = await response.blob();
  const downloadUrl = URL.createObjectURL(blob);

  // Create download link
  const a = document.createElement('a');
  a.href = downloadUrl;
  a.download = 'output.png';
  a.click();

  console.log('Generation complete');
}
```


## Additional Resources

### Documentation

- [Model Playground](https://www.segmind.com/models/seedance-2.0)
- [API Documentation](https://www.segmind.com/models/seedance-2.0/api)
- [Pricing Details](https://www.segmind.com/models/seedance-2.0/pricing)
- [Platform Documentation](https://docs.segmind.com/)

### Tags

No tags available