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

# Seedance 1.0 Pro

> Seedance 1.0 Pro: text and image-to-video model. Request examples and parameters for MixRoute.

Seedance 1.0 Pro is a ByteDance video model. Use the complete route ID `seedance-1-0-pro-250528`; the version suffix is part of the ID.

Full field definitions: [Seedance API](/api-reference/endpoint/seedance).

## Model Parameters and Limits

| Setting | Value |
| - | - |
| `model` | `seedance-1-0-pro-250528` |
| Input modes | Text, first-frame image, or first/last-frame images. |
| `metadata.content` | Required input array. Include a text item for text-only generation and keep it consistent with prompt. |
| `metadata.duration` | 2-12 seconds; -1 is not supported. |
| `metadata.resolution` | `480p`, `720p`, `1080p`; default 1080p. |
| `metadata.ratio` | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive` |
| Audio | Silent output. Do not send generate\_audio. |
| Format | `mp4` |
| Frame rate | 24 fps |

* Keep `model`, `prompt`, and `asset` at the root; every provider field belongs in `metadata`. Set `asset=true` for the media-input examples.
* Frame roles and `reference_*` roles are separate input modes; do not combine them.
* This legacy version does not accept video/audio references or reference\_image inputs. Use only the frame-input modes listed above; confirm account access before calling its model ID.
* Text-to-video defaults to 16:9 and does not accept adaptive; image-to-video defaults to adaptive.

## Examples

Set `MIXROUTE_API_KEY` and replace image/video/audio placeholders with accessible source media before calling.

### Text-to-Video

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-1-0-pro-250528",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "watermark": false
  }
}'
```

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "seedance-1-0-pro-250528",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "1:1",
    "watermark": false
  }
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=60,
)
response.raise_for_status()
result = response.json()
if result.get("code") not in (None, 0, 200, "0", "200", "success"):
    raise RuntimeError(result.get("message") or result)
print(result)
```

### First-Frame Image

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/video/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-1-0-pro-250528",
  "prompt": "A ceramic mug slowly rotates on a white tabletop in soft daylight.",
  "asset": true,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A ceramic mug slowly rotates on a white tabletop in soft daylight."
      },
      {
        "type": "image_url",
        "image_url": {
          "url": "https://example.com/first-frame.png"
        },
        "role": "first_frame"
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "adaptive",
    "watermark": false
  }
}'
```

## Task Result

Retain the submitted MixRoute task ID and use [Query Video Task](/api-reference/endpoint/query-video-task). Read the video URL only after a successful terminal status; submission does not mean generation is complete.


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