Seedance 1.5 Pro - MixRoute API

Seedance 1.5 Pro 是 ByteDance 影片模型。請求使用完整路由 ID seedance-1-5-pro-251215，版本字尾屬於 ID 的一部分。完整欄位說明見 Seedance API。

模型參數與限制

設定	取值
`model`	`seedance-1-5-pro-251215`
輸入方式	文本、首幀影像或首尾幀影像。
`metadata.content`	必填輸入陣列。文生影片須包含文本項，內容與頂層 prompt 保持一致。
`metadata.duration`	4-12 / -1 秒；-1 自動選擇時長。
`metadata.resolution`	`480p`, `720p`, `1080p`；預設 720p。
`metadata.ratio`	`21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `adaptive`
音訊	`metadata.generate_audio` 預設 true；false 輸出無聲影片。
格式	`mp4`
幀率	24 fps

頂層保留 model、prompt、asset；全部廠商欄位放入 metadata。媒體輸入示例設定 asset=true。
首尾幀角色與 reference_* 角色屬於不同輸入方式，不要混用。
此舊版本不支援影片參考、音訊參考或 reference_image 輸入，只使用上表列出的幀影像輸入方式；呼叫前先確認賬戶是否仍提供該模型 ID。
預設寬高比為 adaptive，也可選擇受支援的具體比例。

呼叫示例

先設定 MIXROUTE_API_KEY，並將影像、影片、音訊佔位地址替換為可訪問的源素材。

文生影片

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-5-pro-251215",
  "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",
    "generate_audio": false,
    "watermark": false
  }
}'

Python

import json
import os
import requests

payload = json.loads(r'''
{
  "model": "seedance-1-5-pro-251215",
  "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",
    "generate_audio": false,
    "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)

首幀圖生影片

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-5-pro-251215",
  "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",
    "generate_audio": false,
    "watermark": false
  }
}'

任務結果

儲存提交返回的 MixRoute 任務 ID，使用查詢影片任務輪詢；任務成功後再讀取影片 URL，提交成功不代表影片已經生成完成。