> ## 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.

# Dreamina Seedance 2.5

> 通過 Dreamina 路由呼叫 Seedance 2.5，支援多模態參考和同步音訊的影片生成。

通過 Dreamina 路由呼叫 Seedance 2.5，支援多模態參考和同步音訊的影片生成。

## 模型資訊

| 欄位         | 說明                           |
| ---------- | ---------------------------- |
| `model`    | dreamina-seedance-2-5-260628 |
| `endpoint` | POST /v1/video/generations   |

## 能力與使用

* 輸出支援 480p、720p、1080p，預設 720p；時長為 4-30 秒或 -1 自動決定。
* model、prompt、asset 保留在頂層；content、resolution、duration、ratio、generate\_audio 等廠商欄位放在 metadata。
* 影片編輯使用 metadata.duration=-1；編輯與續寫使用 metadata.ratio=adaptive。1080p 輸出採用 10-bit H.265/HEVC，需要相容的播放器。

## 請求示例

呼叫前設定 `MIXROUTE_API_KEY`。

```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": "dreamina-seedance-2-5-260628",
  "prompt": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting.",
  "asset": false,
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A red ceramic mug slowly rotates on a white tabletop. Static camera, soft studio lighting."
      }
    ],
    "duration": 4,
    "resolution": "480p",
    "ratio": "16:9",
    "generate_audio": false
  }
}'
```

## 請求欄位

| 欄位         | 說明                                          |
| ---------- | ------------------------------------------- |
| `model`    | 必填，使用上方完整模型 ID。                             |
| `prompt`   | 必填的 MixRoute 提示詞，與 metadata.content 文本保持一致。 |
| `asset`    | 頂層媒體處理選項。                                   |
| `metadata` | 廠商欄位，包括 content 及所有生成設定。                    |

提交後建立非同步任務。儲存返回的 MixRoute 任務 ID，通過[查詢影片任務](/zh-hant/api-reference/endpoint/query-video-task)輪詢到終態；不要僅因客戶端超時而重複提交。

完整請求格式見[介面說明](/zh-hant/api-reference/endpoint/dreamina)。