Seedance 2.5 Flash 建立影片(原生格式)
使用原生介面建立 Seedance 2.5 Flash 影片任務。
透過原生格式建立 Seedance 2.5 Flash 影片任務,提交後回傳任務 ID。
取得生成結果
使用回傳的任務 ID 透過查詢介面確認狀態並取得生成影片。使用素材 ID 時,可先透過上傳素材完成素材匯入。
火山方舟建立影片生成任務官方文件查看上游協定定義與最新欄位變更。影片生成模型 ID。Seedance 2.5 Flash 的模型 ID 為 doubao-seedance-2-5-flash-261115;也可使用對應的 Endpoint ID。
輸入文字、圖片、影片或音訊。參考素材最多為 10 張圖片、5 段影片與 5 段音訊;影片、音訊單段為 2~30 秒,同類素材總時長分別不超過 30 秒。影片編輯的參考影片須為 4~30 秒。支援純音訊參考。
單首幀傳一張圖片,role 可省略或為 first_frame;首尾幀傳兩張圖片,分別明確填寫 first_frame 和 last_frame。參考圖片、影片、音訊必須填寫對應的 reference_* 角色。首幀、首尾幀與多模態參考模式不能混用;尾幀比例與首幀不同時會裁切以配合首幀。
圖片和音訊支援公開 URL、Base64 data URI 或 asset://ASSET_ID;影片支援公開 URL 或素材 ID。請求本文不超過 64 MB,大檔案優先使用 URL。提示詞可用 @圖像1、@影片1、@音訊1 引用對應素材。
1 <= items不支援 Draft 樣片模式。省略此欄位或填寫 false,請勿傳入 true。
false可用值
全模態參考任務類型。auto 自動判定;reference 參考生成;edit 影片編輯,須包含參考影片且 ratio=adaptive、duration=-1;extend 影片延長,須包含參考影片且 ratio=adaptive。明確指定類型會提前校驗對應限制;實際判定與指定類型不一致時,仍可能非同步失敗。
"auto"可用值
是否產生與畫面同步的聲音。true 根據提示詞與視覺內容產生匹配的人聲、音效和背景音樂;false 產生無聲影片。輸出有聲影片為雙聲道,與輸入音訊的聲道數無關。
true影片長寬比。文字生成影片和多模態參考生成影片可指定比例或使用 adaptive;起始影格、起始與結束影格、影片編輯和影片延長任務僅支援 adaptive。
"adaptive"可用值
生成長度,單位為秒。支援 4 到 30,或傳 -1 由模型自動決定。影片編輯任務僅支援 -1,影片延長支援 4 到 30 或 -1。
-1輸出影片的解析度,支援 480p、720p。實際像素尺寸由解析度與長寬比共同決定。
"720p"可用值
輸出影片格式。mp4 適合網頁與常規分發;mov 使用 H.264、YUV444P 和 PCM,適合調色、去背與合成等後期場景。
"mp4"可用值
是否在影片右下角加入「AI 生成」浮水印。true 加入,false 不加入。
false隨機種子,取值範圍為 -1 到 4294967295。相同種子可增強結果的可復現性,但不保證完全一致。
-1 <= value <= 4294967295是否傳回影片尾幀。設為 true 時,可從查詢結果的 content.last_frame_url 取得無浮水印 JPEG 圖片,尺寸與影片一致,可用於連續影片生成;false 不傳回尾幀。
false任務狀態變更時接收 POST 通知的網址,通知結構與原生查詢回應一致。未設定時可輪詢查詢介面。
通知狀態包含 queued、running、succeeded、failed 和 expired。成功或失敗通知在 5 秒內未收到成功接收確認時,會重試三次。
uri英文字串形式的終端使用者識別碼,對同一使用者應固定且唯一,最長 64 個字元。建議傳入使用者名稱、使用者 ID 或電子郵件的雜湊值,避免提交個人資訊。
1 <= length <= 64任務從建立開始的有效時間,單位為秒。超過此時間後,仍未完成的任務將進入過期狀態。
int323600 <= value <= 259200172800設定連網搜尋工具。模型依提示詞自行決定是否搜尋,可提高內容時效性,也可能增加延遲。實際搜尋次數見 usage.tool_usage.web_search;0 表示未執行搜尋。
服務等級。Seedance 2.5 Flash 僅支援 default 線上推論,不支援 flex;排隊優先順序透過 priority 設定。
"default"同一推論端點內的排隊優先順序,取值 0~9,數值越大越優先;同優先順序依提交順序處理,不中斷正在執行的任務。
0 <= value <= 90