Seedance 官方版影片 API 規範

seedance-2.5官方版、seedance-2.0官方版、seedance-2.0-fast官方版與 seedance-2.0-mini官方版依解析度計費的呼叫方式，以及時長、比例、參考素材與首尾影格規則。

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

更新於 2026-10-10。這組模型只支援輪詢：提交時請勿設定 callback_url，否則請求會被拒絕。SD 雲廠商版（SD2.0、SD2.5）與 Seedance 官轉的能力和本組不同，請分別參閱 SD 雲廠商版與Seedance 官轉。

模型一覽

模型	可選解析度	時長	預設時長	圖／影片／音訊上限	首尾影格
`seedance-2.5官方版`	`720p`（預設）	4–30 秒	4 秒	30 / 10 / 10	支援，與一般參考素材互斥
`seedance-2.0官方版`	`720p`（預設）	4–15 秒	4 秒	9 / 3 / 3	支援，與一般參考素材互斥
`seedance-2.0-fast官方版`	`720p`（預設）	4–15 秒	4 秒	9 / 3 / 3	支援，與一般參考素材互斥
`seedance-2.0-mini官方版`	`480p`（預設）、`720p`	4–15 秒	5 秒	9 / 3 / 3	不支援首尾影格模式

模型名稱必須與 GET /v1/models 回傳的 id 完全一致，包括 官方版 後綴。每個系列只有一個模型名稱，以 resolution 選擇輸出規格並依該規格計費；日後新增規格時模型名稱不變。

通用規則

解析度：resolution 填入上表中的規格，大小寫皆可（720p 與 720P 等價）；未傳時使用最低規格。填入該系列不支援的規格會回傳 400，不會自動降級。
時長：duration（或字串形式的 seconds）填整數秒；未傳時使用上表的預設時長。
比例：ratio（或 aspect_ratio）可選 16:9、9:16、1:1、4:3、3:4、21:9，預設為 16:9。不支援 auto。
提示詞：prompt 為必填。
音訊：不提供生成音訊開關，請勿傳送 generate_audio。
選填欄位：negative_prompt（負面提示詞）、seed（整數）。

參考素材

參考圖片放在頂層 images 陣列。
參考影片放在 metadata.referenceVideos，參考音訊放在 metadata.referenceAudios。
同一類素材只用一個欄位提交；同時提交多個別名時只會採用其中一組，不會合併。
素材 URL 要求與本機檔案上傳方式，請見素材 URL 要求與本機素材上傳。

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "使用參考圖的產品外觀、參考影片的鏡頭節奏與參考音訊的聲音氛圍，製作科技廣告",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

首尾影格

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

{
  "model": "seedance-2.0官方版",
  "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。

先前帶有規格的模型名稱 Seedance-2.5-720p官方版、Seedance-2.0-720p官方版、Seedance-2.0-fast-720p官方版、seedance-2.0-mini-480p、seedance-2.0-mini-720p 仍可呼叫，輸出與計費固定為名稱中的規格，並會忽略 resolution。這些名稱已不在模型廣場顯示，新串接請使用上表的系列名稱搭配 resolution。