# Seedance 2.5 Flash (https://wanapi.app/zh-tw/docs/seedance-2-5-flash)





根據文字、影格或參考素材生成影片，或編輯來源片段。[模型與試驗區](/zh-tw/models/seedance-2-5-flash)。

## 建立任務 [#建立任務]

在伺服器端於 [API 金鑰設定](/zh-tw/settings/apikeys) 建立金鑰。傳送一次 POST 至 `https://api.wanapi.app/v1/videos`，並儲存回傳的 `id`。

```bash
curl https://api.wanapi.app/v1/videos -H "Authorization: Bearer $WAN_API_KEY" -H "Content-Type: application/json" -d '{"model":"bytedance/seedance-2.5-flash","prompt":"A paper boat floats through a sunlit stream. Slow tracking shot.","resolution":"720p","aspectRatio":"16:9","duration":4,"generateAudio":true}'
```

## 請求欄位 [#請求欄位]

使用 `model: "bytedance/seedance-2.5-flash"` 和非空的 `prompt`。將 `resolution` 設為 480p 或 720p（預設值）。生成影片的長度可透過 `duration` 設為 4 到 30 秒（預設為 5 秒）。若要輸出無聲影片，請設 `generateAudio: false`。每個任務輸出一部影片，影格率固定為 24 fps。

文字與參考素材生成使用固定的 `aspectRatio`：16:9（預設）、9:16、1:1、4:3、3:4 或 21:9。設定首幀與尾幀時，開場影格請傳入 `image`，或使用 `frameImages`，其中包含一個 first\_frame 和可選的 last\_frame。每個影格項目都有 `frameType` 和 `image` URL。影格與編輯會採用自適應構圖。

將參考圖片或參考影片傳入 `inputReferences`，每項包含 `type: "url"`、`url` 和 `mediaType`。最多可傳入 10 張圖片、5 部影片和 5 段音訊片段。音訊 URL 請傳入 `providerOptions.bytedance.referenceAudio`。每次請求請擇一使用首尾影格或參考素材。

若要編輯，請將 `providerOptions.bytedance.omni_reference_task_type` 設為 `edit`，提供剛好 1 部參考影片，並省略 duration 或將其設為 -1。另一種任務類型 `generate` 是預設值。內容過濾預設為 true。API 用戶端可將 `providerOptions.bytedance.content_filter` 設為 false。

## 媒體規格 [#媒體規格]

請使用可公開讀取且不含憑證的 HTTP(S) URL。圖片格式：JPEG、PNG 或 WebP，大小上限為 30 MB。圖片與影片：每邊 300–6000 像素，長寬比為 0.4–2.5。

影片格式：MP4 或 MOV，大小上限為 200 MB，24–60 fps，409600–8295044 像素。參考素材長度為 2–30 秒；編輯來源則為 4–30 秒。影片總長度最多為 30 秒。

音訊格式：MP3 或 WAV，每段片段大小上限為 15 MB，長度為 2–30 秒，合計最多 30 秒。

## 輪詢與下載 [#輪詢與下載]

使用相同的 API 金鑰輪詢 `GET https://api.wanapi.app/v1/videos/{id}`。對 queued 或 in\_progress 任務持續輪詢。任務 completed 後，下載 `videos[0].url`。請以 API 主機為基準解析相對網址，並向該主機驗證身分。直接使用已簽署的媒體網址。任務 failed 時，讀取 `error.message`。使用相同的任務 ID 重試失敗的輪詢。

## 價格 [#價格]

<SeedanceModelPricing model="findSeedanceModel('seedance-2-5-flash')" />

已包含音訊。請參閱[計費秒數指南](/zh-tw/blog/seedance-2-5-flash-pricing)，了解參考影片與編輯的計算方式。

[下載 OpenAPI](/models/seedance-2-5-flash/openapi.json)。
