跳至主要内容

Seedance A 系列

本頁聚焦 A 系列的 2.0-A 與 2.5-A。兩者都支援圖片、參考影片與參考音訊；影片參考模式至少需要一條影片，音訊可選。

本頁範圍​

  • seedance2.0-A
  • seedance2.5-A

能力矩陣​

模型輸出秒數解析度圖片上限影片上限音訊上限素材總數
seedance2.5-A4–30480p / 720p30101050
seedance2.0-A4–15480p / 720p / 1080p93312

素材模式與組合​

A2.0、A2.5、E720 顯示「參考影片／音訊」：至少一條影片，音訊可選。固定30秒B顯示「參考影片」，不支援音訊。B2.0、fastB、F、C顯示「參考音訊」：至少一條音訊，此模式不混入影片或圖片。

普通參考圖片需至少一圖，這些支援音訊的 Seedance 預設亦明確允許附加音訊。文字生成影片不带參考素材；首幀恰好一圖，首尾幀恰好兩張不同圖片。A2.0首尾素材必須成對，比例auto。E/F、A2.5、固定30秒B及C目前不開放首尾幀。

來源、檔案與時長​

系列來源與單檔限制參考片段限制
A2.0HTTPS公開URL；每檔100 MB影片每條1.8–15秒、總15秒；音訊每條2–15秒、總15秒；影片像素數409600–8295044
A2.5HTTPS公開URL；每檔100 MB影片及音訊各自總時長最多30秒
B2.0 / fastBHTTPS或完整Data URL；圖20 MB、音訊300 MB音訊總15秒；不支援影片
E720 / FHTTPS或完整Data URL；圖20 MB、影片／音訊50 MB預設影片（僅E720）及音訊各最多15秒，各自總15秒
CHTTP/HTTPS公開URL；大小上限未公布不支援影片；參考音訊每個檔案及合計最多15秒
固定30秒BHTTPS公開URL；source不得重複沒有已公布且可直接套用的片段時長上限

「公開」標籤代表保留可提交的HTTP(S)地址，不保證免驗證、不過期或服務可讀。A系列更要求HTTPS。普通剪貼簿、裁切及本機檔案不會自動取得公開URL，系統不提供公開上傳轉換；只有明確允許Data URL的型號可用本機編碼。C的data:輸入會回傳unsupported protocol: data。

欄位、預設與差異​

欄位型別說明
modelstring使用上表公開ID，不使用舊型號
promptstring描述動作及鏡頭；素材依下文編號
secondsinteger整數；duration為相容欄位，兩者須相同；C須明確填寫，固定30秒B只能30
resolutionstring屬於型號清單；不按名稱猜品質或解析度
aspect_ratiostring常規16:9、4:3、1:1、3:4、9:16、21:9；A2.0有auto，B有adaptive，E/F無adaptive，C目前16:9/9:16
referencesobject[]物件陣列；type=image/video/audio，role表示用途，source為URL或允許的Data URL
task_modestringB2.0/fastB：text、first_frame、first_last_frame、references；E/F：text、references；不可直接填Canvas模式值
generate_audioboolean僅輸出音軌；C開放且服務預設false，與參考音訊獨立。B服務資料有列出，但目前Canvas不開放
return_last_frame / web_searchbooleanB2.0/fastB專用可選布林值，Canvas未提供；E/F不支援
priorityintegerB2.0/fastB專用整數0–9，Canvas未提供；其他型號不通用

介面預設：A2.0/A2.5為4秒/480p，B2.0/fastB為5秒/720p，E/F為5秒/固定解析度，C為10秒/720p，固定30秒B為30秒/720p；比例16:9。明確填參數可避免服務預設差異。

差異：A2.0服務資料列4K，PopGo保留已驗證的480/720/1080p並關閉4K。F1080公開名稱與服務資料有差異，保留F1080及影片0的設定，不套用另一型號能力。C依目前已確認的圖片／音訊契約。

統一參考結構與範例​

統一使用references；普通素材role為reference，C音訊role為reference_audio並保留至發出請求。不要混送統一陣列及多套別名。source不得重複；首尾幀只用image及first_frame/last_frame，不混普通參考。

A2.0提示詞需逐一引用素材：@图1或@图片1、@视频1、@音频1，從1開始且無前導0；遺漏可能422。C音訊使用@Audio1、@Audio2。調整順序後需核對編號。

以下依序是普通圖片、首尾幀、影片加音訊、C純音訊。以對應型號替換YOUR_MODEL；素材URL必須可供服務讀取。

{
  "model": "YOUR_MODEL",
  "prompt": "Animate @图1 with a smooth camera movement",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "references": [
    {
      "type": "image",
      "role": "reference",
      "source": "YOUR_IMAGE_URL"
    }
  ]
}
{
  "model": "YOUR_MODEL",
  "prompt": "Move smoothly from @图1 to @图2",
  "seconds": 8,
  "resolution": "720p",
  "aspect_ratio": "auto",
  "references": [
    {
      "type": "image",
      "role": "first_frame",
      "source": "YOUR_FIRST_FRAME_URL"
    },
    {
      "type": "image",
      "role": "last_frame",
      "source": "YOUR_LAST_FRAME_URL"
    }
  ]
}
{
  "model": "YOUR_MODEL",
  "prompt": "Follow the movement in @视频1 and rhythm in @音频1",
  "seconds": 8,
  "resolution": "720p",
  "references": [
    {
      "type": "video",
      "role": "reference",
      "source": "YOUR_VIDEO_URL"
    },
    {
      "type": "audio",
      "role": "reference",
      "source": "YOUR_AUDIO_URL"
    }
  ]
}
{
  "model": "YOUR_MODEL",
  "prompt": "Create a scene following @Audio1",
  "seconds": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "references": [
    {
      "type": "audio",
      "role": "reference_audio",
      "source": "YOUR_AUDIO_URL"
    }
  ]
}

任務、錯誤與費用​

通常每3–5秒輪詢，C建議10–15秒。保存PopGo的id；queued/in_progress等待，completed下載，failed檢查原因。POST不具冪等性，建立逾時先查原任務再考慮重送。詳見影片任務流程。

錯誤或現象修正
400 source URL invalid / unsupported protocol: dataA/C改用允許的公開來源，A必須HTTPS
400數量、時長、解析度或模式錯誤按目前型號核對，不套用同系列設定
422提示詞缺素材引用修正@編號，引用每個必要素材
下載失敗、403／過期、分享頁換可直接下載的URL；瀏覽器預覽不證明服務可讀
成片未使用素材分別检查Canvas驗證、PopGo解析、發出欄位、服務接受及成片

費用可按次、按秒或規格倍率，由PopGo即時價格及NewAPI任務計費決定，不從名稱或缺少usage推斷。HTTP 200與任務ID只證明對應階段。本功能僅經源碼、Mock及離線瀏覽器測試，真實生成效果仍需獨立驗證。