我可以上傳臉部照片並在 Seedance 中重複使用嗎？

可以。你可以把臉部或人物照片上傳為 private asset 並在 Seedance 影片生成中引用，但它應被視為參考引導生成，而不是保證精準的 face swap。

Seedance Private Asset Library 和 face swap 一樣嗎？

不一樣。它讓 Seedance 使用上傳的 assets 作為可重複使用生成參考，目標是在生成影片中保持角色或主體一致。

可以把人物 private asset 和風景圖結合嗎？

可以。常見做法是把人物 asset 放在 image_urls 第一位，把風景圖 URL 放在第二位，然後在 prompt 中說明 Image 1 和 Image 2 的角色。

哪些 Seedance API task types 支援 private assets？

private assets 支援 seedance-2-less-restriction 和 seedance-2-fast-less-restriction。seedance-2 與 seedance-2-fast 不支援 asset://。

private assets 和 auto-upload mode 有什麼差異？

private assets 是上傳一次並重複使用的託管參考。auto-upload mode 會在 auto_upload_assets: true 時為一次性任務暫時導入原始 URL。

可以在 Playground 測試 private assets 嗎？

private assets 主要是 API 和 backend 工作流程。如果 Playground 沒有 asset upload、狀態、asset:// 和 less-restriction task type，通常用 cURL、Postman 或 backend code 測試。

如何透過 Seedance API 使用 Seedance Private Assets

Q: 什麼是 Seedance private asset？

Seedance private asset 是上傳到 PiAPI、用於 Seedance 影片生成的可重複使用參考。狀態變為 Active 後，你可以在後續任務中透過 asset:// 引用它。

PiAPI 現在支援 Seedance Private Asset Library。這是一個新的 Seedance API 工作流程，可上傳可重複使用的參考素材，並在後續任務中透過 asset://<asset_id> 呼叫。

Seedance Private Asset Library 適合上傳臉部、角色、產品、場景、影片或音訊參考，並在多次 Seedance API 任務中重複使用。它主要用於可重複使用參考與角色一致性，不是傳統 face swap、inpainting 或像素級圖片編輯。

重點

當同一張臉、角色、產品或主體需要出現在多個未來影片中時，使用 private assets。
一次性背景、場景或道具繼續使用原始 URL。
如果使用者提供的參考只用於單次任務，可使用 auto_upload_assets: true。
private asset 必須達到 Active 狀態後才能在 Seedance 任務中引用。
asset:// 適用於 seedance-2-less-restriction 和 seedance-2-fast-less-restriction，不適用於 strict task types。

快速回答

Seedance private assets 最適合 Seedance API 中可重複使用的參考。先上傳參考素材，等待狀態變為 Active，再於後續影片任務中使用 asset://<asset_id>。

Seedance Private Assets 是什麼？

它是應用程式在生成影片前上傳到 PiAPI 的可重複使用檔案。上傳後 PiAPI 會回傳 asset_id。當 asset 變成 Active 後，Seedance API 請求即可用 asset://<asset_id> 引用。endpoint、配額與生命週期規則請參考 Private Asset Library docs。

它解決什麼問題？

AI 影片生成在同一主體需要跨多個 prompt、場景或創意版本保持一致時會變得複雜。原始圖片 URL 可用於單次任務，但不適合長期重複使用。private assets 提供了可管理的重複使用參考層。

如果想先了解模型整體能力，可以閱讀 Seedance 2.0 API guide。

Private Assets 不是什麼？

Seedance Private Asset Library 不應被描述為 face swap、inpainting 或精準照片合成。它讓 Seedance 使用上傳素材作為生成參考，目標是在生成影片中保持角色或主體一致，而不是精準替換現有圖片或影片中的臉。

Private Assets、原始 URL 與 Auto-Upload

模式	最適合	範例	何時使用
Managed private asset	可重複使用人物、角色、產品或主體	`asset://asset-123`	同一參考會用於多個未來任務。
Raw URL	一次性背景、場景或道具	`https://your-cdn.com/scene.jpg`	參考只對目前任務有意義。
Auto-uploaded ephemeral asset	臨時使用者參考	URL + `auto_upload_assets: true`	需要 PiAPI 暫時導入一次性素材。

簡單規則：未來會重複使用就做成 private asset，只用一次就保留原始 URL 或使用 auto-upload。

工作流程

上傳可重複使用參考。
等待 asset 狀態變為 Active。
在 image_urls、video_urls 或 audio_urls 中提交 asset://<asset_id>。
在 prompt 中依照輸入順序寫 Image 1、Image 2、Video 1 或 Audio 1。
輪詢 Seedance 任務直到影片完成。

{
  "image_urls": ["asset://asset-person-reference", "https://your-cdn.com/scenic-background.jpg"],
  "prompt": "Image 1 is the person reference. Image 2 is the scenic background. Generate a cinematic 5-second video."
}

API 範例

先呼叫 https://api.piapi.ai/api/v1/asset/upload 上傳參考圖片，再用 asset list endpoint 輪詢狀態。確認 Active 後，在 seedance-2-less-restriction 或 seedance-2-fast-less-restriction 任務中使用 asset://<asset_id>。strict 版本如 seedance-2 與 seedance-2-fast 不支援 private asset references。

最佳實務

將需要長期一致的臉部、主角、產品或品牌主體做成 private assets。
一次性背景繼續使用原始 URL。
在 prompt 中清楚標示 Image 1、Image 2 等輸入。
生成前等待 Active。
規劃配額、TTL，並確保使用者擁有或同意使用相關參考。

FAQ

什麼是 Seedance private asset？

它是上傳到 PiAPI、用於 Seedance 影片生成的可重複使用參考。狀態變為 Active 後，可透過 asset://<asset_id> 在後續任務中呼叫。

可以上傳臉部照片並重複使用嗎？

可以，但應理解為參考引導生成，不是保證精準的 face swap。

總結

Seedance Private Asset Library 讓開發者更容易在 Seedance API 中建立可重複使用參考工作流程。先上傳一個參考，確認它為 Active，再提交使用該 asset、prompt 和一次性 URL 的 less-restriction 任務。準備連接 API key 時，可以在 Seedance workspace 測試。