Как использовать Seedance Private Assets с Seedance API

PiAPI теперь поддерживает Seedance Private Asset Library — workflow Seedance API для загрузки переиспользуемых референсов и последующего вызова через asset://<asset_id>.
Библиотека позволяет загружать лицо, персонажа, продукт, сцену, видео или аудио и повторно использовать их в задачах Seedance API. Она подходит для reusable references и consistency персонажей, но не является классическим face swap, inpainting или pixel-perfect редактированием изображений.
Главное
- Используйте private assets, когда лицо, персонаж, продукт или объект должны появляться в нескольких будущих видео.
- Используйте raw URL для одноразовых фонов, сцен, props или референсов.
- Используйте
auto_upload_assets: trueдля временного пользовательского референса в одной задаче. - Asset должен получить статус
Activeперед использованием в Seedance. asset://работает сseedance-2-less-restrictionиseedance-2-fast-less-restriction, но не со strict task types.
Короткий ответ
Seedance private assets нужны для переиспользуемых референсов в Seedance API. Загрузите референс один раз, дождитесь Active, затем используйте его в будущих video tasks через asset://<asset_id>.
Что такое Seedance Private Assets?
Это переиспользуемые файлы, которые приложение загружает в PiAPI до генерации видео. После загрузки PiAPI возвращает asset_id. Когда asset становится Active, запросы Seedance API могут использовать asset://<asset_id>. Подробности endpoint, квот и lifecycle есть в Private Asset Library docs.
Какую проблему они решают?
AI video generation часто испытывает сложности, когда один и тот же объект должен оставаться стабильным в разных prompts, сценах или creative variations. Raw image URL подходит для одной задачи, но неудобен для многократного использования.
Типичные сценарии: сохранять одного человека или персонажа, строить avatar или influencer products, переиспользовать product reference в объявлениях, поддерживать стабильный cast и уменьшать повторные uploads в backend. Для обзора модели начните с Seedance 2.0 API guide.
Чем Private Assets не являются
Seedance Private Asset Library не является face swap, inpainting или точной фотокомпозицией. Seedance использует входные данные как generation references. Результат — видео, направленное референсом, а не точная замена лица или пиксельное редактирование.
Private Assets vs Raw URL vs Auto-Upload
| Паттерн | Лучше всего для | Пример | Когда использовать |
|---|---|---|---|
| Managed private asset | Повторяющиеся люди, персонажи, продукты или объекты | asset://asset-123 | Когда один референс нужен в нескольких задачах. |
| Raw URL | Одноразовый фон, сцена или prop | https://your-cdn.com/scene.jpg | Когда референс важен только сейчас. |
| Auto-uploaded ephemeral asset | Временные пользовательские референсы | URL + auto_upload_assets: true | Когда PiAPI должен временно ingest файл. |
Правило простое: если референс будет использоваться снова, сделайте private asset; если только один раз — используйте raw URL или auto-upload.
Workflow
- Загрузите reusable reference.
- Дождитесь статуса
Active. - Отправьте Seedance task с
asset://<asset_id>вimage_urls,video_urlsилиaudio_urls. - В prompt используйте
Image 1,Image 2,Video 1илиAudio 1по порядку inputs. - Poll задачу до завершения видео.
{
"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 используйте asset://<asset_id> в задаче seedance-2-less-restriction или seedance-2-fast-less-restriction. Strict варианты seedance-2 и seedance-2-fast не поддерживают private asset references.
Best practices
- Используйте private assets для повторяющихся лиц, главных персонажей, продуктов или brand subjects.
- Одноразовые фоны оставляйте raw URL.
- Четко подписывайте inputs в prompt:
Image 1,Image 2. - Ждите
Activeперед генерацией. - Планируйте квоты, TTL и согласие на использование пользовательских референсов.
FAQ
Что такое Seedance private asset?
Это переиспользуемый референс, загруженный в PiAPI для Seedance video generation. После Active он используется через asset://<asset_id>.
Можно ли переиспользовать фото лица?
Да, как reference-guided generation. Это не гарантирует точный face swap.
Итог
Seedance Private Asset Library дает разработчикам более чистый способ строить reusable reference workflows с Seedance API. Загрузите референс, подтвердите Active, затем отправьте less-restriction task с asset, prompt и одноразовыми raw URLs. Тестировать можно в Seedance workspace.

