> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.0 (reference-to-video) Video to Video API

> Seedance 2.0 reference-to-video generates video from reference images, videos, and audio with improved motion quality and synchronized audio.

[← Seedance](https://docs.creatify.ai/api-documentation/ai-generation/models/seedance.md)

**Model name:** `bytedance/seedance-2.0/reference-to-video`\
**Generation type:** `video_to_video`\
**Endpoint:** [`POST /api/asset_generator/`](https://docs.creatify.ai/api-reference/ai-generation/post-ai-generation)

## Pricing

| Duration | 480p | 720p | 1080p | 4k |
| - | - | - | - | - |
| 4s | **2.75** | **6.25** | **13.75** | **31.25** |
| 5s | **3.5** | **7.75** | **17.25** | **39** |
| 6s | **4.25** | **9.25** | **20.5** | **47** |
| 7s | **4.75** | **10.75** | **24** | **54.75** |
| 8s | **5.5** | **12.25** | **27.5** | **62.5** |
| 9s | **6.25** | **13.75** | **30.75** | **70.25** |
| 10s | **6.75** | **15.25** | **34.25** | **78** |
| 11s | **7.5** | **16.75** | **37.75** | **86** |
| 12s | **8.25** | **18.25** | **41** | **93.75** |
| 13s | **9** | **19.75** | **44.5** | **101.5** |
| 14s | **9.5** | **21.25** | **47.75** | **109.25** |
| 15s | **10.25** | **23** | **51.25** | **117** |

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

## Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

```bash cURL theme={null}
curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "bytedance/seedance-2.0/reference-to-video",
    "input_params": {
      "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
      "image_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
      ],
      "video_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
      ],
      "audio_urls": [
        "https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
      ]
    }
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "bytedance/seedance-2.0/reference-to-video",
        "input_params": {
            "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
            "image_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
            ],
            "video_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
            ],
            "audio_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
            ]
        },
    },
)
print(response.json()["id"])
```

## Input parameters

Send these fields in `input_params`.

**prompt** `string` *required*

The text prompt used to generate the video

**seed** `integer`

Random seed to control video generation. Use -1 for random.

Minimum: `-1`.
Maximum: `4294967295`.

**duration** `string` (default: auto)

Duration of the video in seconds

Allowed values: `"auto"`, `"4"`, `"5"`, `"6"`, `"7"`, `"8"`, `"9"`, `"10"`, `"11"`, `"12"`, `"13"`, `"14"`, `"15"`.

**resolution** `string` (default: 720p)

Video resolution - 480p for faster generation, 720p for balance

Allowed values: `"480p"`, `"720p"`, `"1080p"`, `"4k"`.

**aspect\_ratio** `string` (default: 16:9)

The aspect ratio of the generated video

Allowed values: `"auto"`, `"21:9"`, `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`.

**image\_urls** `string[]`

Up to 9 reference images (JPEG, PNG, WebP, max 30MB each).

Maximum items: `9`.

**video\_urls** `string[]`

Up to 3 reference videos (MP4, MOV, 2-15s combined, max 50MB total).

Maximum items: `3`.

**audio\_urls** `string[]`

Up to 3 audio files (MP3, WAV, max 15s combined, 15MB per file). Requires at least one image or video reference.

Maximum items: `3`.

**generate\_audio** `boolean` (default: true)

Whether to generate synchronized audio for the video

> [accordion] Complete JSON schema
>
> ```json theme={null}
> {
>   "$schema": "http://json-schema.org/draft-07/schema#",
>   "required": [
>     "prompt"
>   ],
>   "properties": {
>     "seed": {
>       "type": "integer",
>       "title": "Seed",
>       "minimum": -1,
>       "maximum": 4294967295,
>       "description": "Random seed to control video generation. Use -1 for random.",
>       "x-advance-settings": true
>     },
>     "prompt": {
>       "type": "string",
>       "title": "Prompt",
>       "description": "The text prompt used to generate the video",
>       "x-support-types": [
>         "mentions"
>       ]
>     },
>     "duration": {
>       "enum": [
>         "auto",
>         "4",
>         "5",
>         "6",
>         "7",
>         "8",
>         "9",
>         "10",
>         "11",
>         "12",
>         "13",
>         "14",
>         "15"
>       ],
>       "type": "string",
>       "title": "Duration",
>       "default": "auto",
>       "description": "Duration of the video in seconds"
>     },
>     "resolution": {
>       "enum": [
>         "480p",
>         "720p",
>         "1080p",
>         "4k"
>       ],
>       "type": "string",
>       "title": "Resolution",
>       "default": "720p",
>       "description": "Video resolution - 480p for faster generation, 720p for balance",
>       "x-advance-settings": true
>     },
>     "aspect_ratio": {
>       "enum": [
>         "auto",
>         "21:9",
>         "16:9",
>         "4:3",
>         "1:1",
>         "3:4",
>         "9:16"
>       ],
>       "type": "string",
>       "title": "Aspect Ratio",
>       "default": "16:9",
>       "description": "The aspect ratio of the generated video"
>     },
>     "image_urls": {
>       "type": "array",
>       "items": {
>         "type": "string",
>         "limit_description": "Max file size: 30MB. Supported formats: JPEG, PNG, WebP."
>       },
>       "title": "Reference Images",
>       "maxItems": 9,
>       "description": "Up to 9 reference images (JPEG, PNG, WebP, max 30MB each).",
>       "max_file_size": 31457280,
>       "min_height": 300,
>       "min_width": 300,
>       "max_height": 6000,
>       "max_width": 6000,
>       "min_aspect_ratio": 0.4,
>       "max_aspect_ratio": 2.5,
>       "max_pixels": 36000000,
>       "x-mention-prefix": "image"
>     },
>     "video_urls": {
>       "type": "array",
>       "items": {
>         "type": "string",
>         "limit_description": "Max total size: 50MB. Duration: 2-15s combined. Supported formats: MP4, MOV. Resolution: 480p-720p."
>       },
>       "title": "Reference Videos",
>       "maxItems": 3,
>       "description": "Up to 3 reference videos (MP4, MOV, 2-15s combined, max 50MB total).",
>       "max_file_size": 52428800,
>       "min_duration": 2,
>       "max_duration": 15,
>       "max_total_duration": 15,
>       "min_pixels": 409600,
>       "max_aspect_ratio": 2.5
>     },
>     "audio_urls": {
>       "type": "array",
>       "items": {
>         "type": "string",
>         "limit_description": "Max file size: 15MB. Duration: max 15s combined. Supported formats: MP3, WAV."
>       },
>       "title": "Reference Audio",
>       "maxItems": 3,
>       "description": "Up to 3 audio files (MP3, WAV, max 15s combined, 15MB per file). Requires at least one image or video reference.",
>       "max_file_size": 15728640,
>       "min_duration": 2,
>       "max_duration": 15,
>       "max_total_duration": 15
>     },
>     "generate_audio": {
>       "type": "boolean",
>       "title": "Generate Audio",
>       "default": true,
>       "description": "Whether to generate synchronized audio for the video",
>       "x-advance-settings": true
>     }
>   }
> }
> ```

## Response

The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](https://docs.creatify.ai/api-reference/ai-generation/get-ai-generation-.md) until `status` is `done` or `failed`, or pass a `webhook_url` to be notified. A finished task lists its files in `assets` and the credits it charged in `credits_used`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.