我可以上传人脸照片并在 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 为后端应用提供了可管理的复用参考层。

常见场景包括：保持同一个人或角色一致、构建 avatar 或 influencer 视频产品、在多个广告创意中复用商品参考、短片中保持稳定演员、将固定人物或产品与不同背景组合，以及减少后端重复上传。

如果你想先了解模型整体能力，可以阅读 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，并确保用户拥有或同意使用相关参考。

常见错误

使用 strict task type。
asset 还在 Processing 时就提交视频任务。
把每个一次性背景都上传成 managed asset。
把 private assets 当作精确图片编辑或 face swap。

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 测试。