SD 雲廠商版影片 API 規範

SD2.0 與 SD2.5 依解析度計費的呼叫方式，以及時長、比例、參考素材、首尾影格與音訊規則。

本頁是 SD 雲廠商版影片模型（SD2.0、SD2.5）的呼叫規範。這些模型與其他影片模型共用 POST /v1/videos 建立、GET /v1/videos/{id} 輪詢的流程；驗證、素材上傳、輪詢狀態、結果下載與錯誤處理請見影片 API 完整呼叫規範，本頁只列出這組模型專屬的欄位與規則。

更新於 2026-10-10。這組模型只支援輪詢：提交時請勿設定 callback_url，否則請求會被拒絕。SD 雲廠商版與 Seedance 官方版、Seedance 官轉屬於不同的模型組，參數與能力不能通用。

模型一覽

模型	可選解析度	時長	比例	圖／影片／音訊上限	首尾影格	生成音訊
`SD2.5`	`480p`（預設）、`720p`、`1080p`	4–30 秒，預設 5 秒	必須指定，見下文	30 / 10 / 10	支援，與一般參考素材互斥	可用 `generate_audio` 設定
`SD2.0`	`480p`（預設）、`720p`、`1080p`、`4k`	4–15 秒，預設 5 秒	預設 `1:1`	9 / 3 / 3，三類合計最多 12	支援，與一般參考素材互斥	無法設定

每個系列只有一個模型名稱，以 resolution 選擇輸出規格並依該規格計費，例如 "model": "SD2.5", "resolution": "720p"、"model": "SD2.0", "resolution": "4k"。

通用規則

解析度：resolution 填入上表中的規格，大小寫皆可（4k 與 4K 等價）；未傳時使用最低規格 480p。填入該系列不支援的規格會回傳 400，不會自動降級。
時長：duration（或字串形式的 seconds）填整數秒；未傳時為 5 秒。
比例：ratio（或 aspect_ratio）可選 16:9、9:16、1:1、4:3、3:4、21:9。
- SD2.5：必須明確指定比例，不支援 auto；未傳或傳入 auto 會回傳 400。
- SD2.0：未傳時為 1:1。
提示詞：
- SD2.5：prompt 為必填。
- SD2.0：提供參考素材或首尾影格時可以省略，但建議寫明動作與鏡頭要求。
生成音訊：SD2.5 支援 generate_audio（布林值）；SD2.0 不支援此開關，傳送會回傳 400。
選填欄位：negative_prompt（負面提示詞）、seed（整數）。

參考素材

參考圖片放在頂層 images 陣列。
參考影片放在 metadata.referenceVideos，參考音訊放在 metadata.referenceAudios。
SD2.0 三類素材合計最多 12 個。
SD2.5 的單段參考影片為 2–30 秒，參考影片合計不超過 30 秒。
同一類素材只用一個欄位提交；同時提交多個別名時只會採用其中一組，不會合併。

{
  "model": "SD2.5",
  "resolution": "1080p",
  "prompt": "保持參考圖人物的臉部與服裝，依參考影片的運鏡在雨夜街頭奔跑",
  "duration": 10,
  "ratio": "9:16",
  "generate_audio": true,
  "images": ["https://cdn.example.com/character.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/camera-motion.mp4"]
  }
}

首尾影格

首影格與尾影格放在 metadata.firstFrame 與 metadata.lastFrame。lastFrame 必須與 firstFrame 同時提供；首尾影格不能與參考圖片、參考影片或參考音訊混用。

{
  "model": "SD2.0",
  "resolution": "720p",
  "prompt": "鏡頭從清晨的海岸平順推進到傍晚的同一片海灣",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

檔案上傳

也可以用 multipart/form-data 直接上傳 1 個本機圖片檔，欄位名稱為 input_reference；此時不能再同時提交 images 或 image。參考影片與音訊無法以檔案形式提交，請先依本機素材上傳取得 URL。

舊模型名稱

先前帶有規格後綴的模型名稱（如 SD2.5 720P、SD2.0 4K）仍可呼叫，輸出與計費固定為名稱中的規格，並會忽略 resolution。這些名稱已不在模型廣場顯示，新串接請使用 SD2.5、SD2.0 搭配 resolution。