Seedance 2.5 Flash
Seedance 2.5 Flash API 參考:影片生成、影格與參考素材、請求範例、任務輪詢、下載與價格。
根據文字、影格或參考素材生成影片,或編輯來源片段。模型與試驗區。
建立任務
在伺服器端於 API 金鑰設定 建立金鑰。傳送一次 POST 至 https://api.wanapi.app/v1/videos,並儲存回傳的 id。
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 重試失敗的輪詢。
價格
| 解析度 | 不含影片輸入 | 含影片輸入 |
|---|---|---|
| 480p | US$0.096 | US$0.06 |
| 720p | US$0.192 | US$0.12 |
已包含音訊。請參閱計費秒數指南,了解參考影片與編輯的計算方式。